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丁 如 敏 


毕业 于 北京 邮电 大 学 ， 近 10 年 的 软件 测试 和 项 目 管理 经 验 ， 精 通 
移动 终端 性 能 测试 、 目 动 化 测试 、 敏 捷 测 试 等 各 种 测试 技术 。 在 腾讯 
工作 期 间 ， 这 领 团队 共 发 明 国家 级 专利 50 多 项 ， 开 发 10 多 门 内 部 培训 
课程 。 襄 欢 挑战 软件 领域 的 各 项 前 脆 技 术 ， 并 有 下 富 的 实践 经 验 。 


盛 娟 


毕业 于 合肥 工业 大 学 计算 机 及 应 用 专业 ， 腾 讯 科技 高 级 测试 工程 
师 。 之 前 先后 服务 于 中 国联 通 、CISCO 中 国 研 发 中 心 ， 有 10 多 年 的 软 


件 测试 和 项 目 管理 经 验 。 近 两 年 主要 人 负 贡 搭建 QQ 浏 蚁 器 Android 端 质 
量 保证 体系 ， 积 素 了 丰富 的 移动 终端 项 目 经 验 。 


陈 航 特 


毕业 于 南 泵 理工 大 学 电子 信息 工程 专业 ， 专 注 于 Android 病 目 动 化 
测试 ， 是 国内 较 早 进入 该 领域 的 探索 者 ， 有 丰富 的 使 用 与 二 次 开发 
Android 原 生 目 动 化 测试 框 染 的 实战 经 验 。 目 前 负责 腾讯 应 用 宇 的 客户 
端 目 动 化 测试 与 相应 的 平台 搭建 工作 。 


陈 六 四 


腾讯 高 级 工程 师 ，12 年 软件 开发 和 测试 工作 经 验 ， 曾 任职 于 多 家 
知名 跨国 企业 ， 现 任职 于 腾讯 公司 ， 从 事 浏 览 器 视频 相关 测试 开发 工 


作 ， 并 在 视频 领域 取得 多 项 国家 级 专利 。 擅 长 工具 开发 、 前 端 性 能 测 


试 和 后 台 性 能 测试 。 


1 a } WY 


邓 曦 


毕业 于 电子 科技 大 学 ， 现 任职 于 腾讯 公司 ， 担 任 无 线 研 发 部 工程 


师 ， 负 责 手 机 QQ 浏览 器 (Android) 测试 工作 。 在 测试 领域 拥有 超过 8 


年 的 经 验 ， 在 自动 化 测试 方面 经 验 丰 富 。 帮 助手 机 QQ 浏览 器 
(Android) 实现 了 从 零 到 行业 第 一 的 飞跃 。 


以 新 


型 


2006 年 北航 本 科 毕 业 ，10 年 软件 测试 经 验 、5 年 移动 互联 网 测试 经 


验 ， 长 期 负责 手机 QQ 浏 哎 右 性 能 测试 ，2013 年 至 2015 年 专职 负 贡 网 页 


打开 速度 测试 。 从 零 开 始 搭建 手机 QQ 浏览 锅 速 度 上 自动 化 测试 方案 。 其 
所 在 的 自动 化 团队 获得 2013 年 MIG 移 动 互联 网 事业 群 SEVP 特 别 奖 。 


休 凯 太 


腾讯 专项 技术 测试 工程 师 ， 主 要 从 事 ROM 级 别 的 App 测 试 工作 ， 
在 Android 目 动 化 方面 有 3 年 实践 经 答 ， 对 跨 应 用 目 动 化 实现 有 许多 心 
得 。 目 动 化 实现 方式 有 很 多 ， 因 需 制定 最 重要 ! 


刘 详 


腾讯 高 级 测试 工程 师 ， 毕 业 于 大 连 交 通 大 学 。 加 入 腾讯 前 分 别 在 
华为 、 中 国 移动 担任 过 系统 测试 工程 师 ， 主 要 从 事 网 络 、 移 动 领域 的 
工作 。 于 2009 年 加 入 腾讯 移动 测试 组 ， 主 要 致力 于 精准 、 代 码 糊 合 、 


窗 盖 率 、 目 动 化 等 方面 的 研究 与 实施 ， 擅 长 Linux、Android 相 关 工 
作 。 


鲁 万 林 


毕业 于 武汉 大 学 ， 曾 任职 于 华为 公司 ， 现 任职 于 腾讯 公司 ， 担 任 
无 线 研 发 部 融 级 工程 师 。 手 机 QQ 浏览 右 Android 平 台 测试 负责 人 , 在 
测试 领域 有 10 多 年 的 经 验 ， 在 成 都 从 无 到 有 建立 了 一 只 强大 的 浏览 需 
测试 团队 ， 帮 助 QQ 浏 宽 器 从 零 飞 路 到 行业 第 一 。 


Pa 


2006 年 毕业 于 浙江 大 学 计算 机 系 。10 年 一 流 公 司 工作 经 验 ， 先 后 
在 SAP、Oracle、 腾 讯 等 公司 从 事 测 试 开 发 工作 ， 目 前 负责 Android 手 


机 QQ 浏览 需 等 产品 的 目 动 化 测试 开发 工作 。 擅 长 工具 开发 ， 对 性 能 测 
试 、 目 动 化 测试 有 深入 的 理解 。 


2009 年 毕业 于 广东 财经 大 学 。 加 入 腾讯 4 年 ， 负 责 过 QQ 浏览 器 国 
际 版 、 新 蜂 ROM、 手 机 应 用 宝 等 移动 端 产品 的 业务 测试 和 自动 化 测 
试 ， 目 前 负责 应 用 宝 的 测试 体系 建设 和 测试 外 包 管 理工 作 。 具 有 多 年 
测试 实战 经 验 ， 擅 长 自动 化 测试 工具 运用 。 


钟 书 成 


毕业 于 成 都 信息 工程 大 学 和 中 国 科 学 院 ， 腾 讯 高 级 测试 工程 师 。 
加 入 腾讯 前 曾 在 多 个 外 企 项 目 中 从 事 测 试 开 发 工作 ， 于 2012 年 加 入 腾 


讯 地 图 项 目 ， 主 要 致力 于 自动 化 测试 的 研究 与 实施 ， 在 Android 自 动 化 
测试 方面 有 丰富 的 经 验 。 在 进行 腾讯 地 图 项 目 期 间 还 负责 八 爪 鱼 自动 
化 测试 平台 的 设计 与 开发 工作 。 


序 


最 近 和 腾讯 移动 品质 中 心 (TMQ) 接触 比较 多 ， 除 了 技术 的 交 
流 ， 还 邀请 TMQ 资 深入 士 参 加 了 某 个 软件 工程 论坛 并 做 了 分 至 ， 关 注 
了 TMQ 公 众 号 。 现 在 很 高 兴 为 这 个 优秀 团队 的 新 书 《 腾 讯 Android 目 
动 化 测试 实战 》 写 序 ， 因 为 可 以 先睹为快 ， 提 前 学 习 腾 讯 的 经 验 。 


现在 移动 应 用 很 普及 了 ， 无 须 摆 事 实 、 讲 道理 ， 读 者 都 深 有 体 
会 。 但 10 年 前 ， 移 动 应 用 还 相对 落后 ， 那 时 TMQ 束 已 经 开始 专注 移动 
App 的 测试 ， 故 这 个 团队 在 移动 应 用 专项 测试 、 精 准 测 试 体 系 及 目 动 
化 测试 方面 都 有 着 丰富 的 实战 经 验 。 这 本 书 就 是 他 们 2015 年 策划 的 移 
动 测试 领域 的 3 本 新 书 之 一 。 这 本 书 专注 Android 目 动 化 测试 ， 和 覆盖 了 
从 环境 配置 、UI 元 素 获 取 、 用 例 编写 到 脚本 开发 、 编 译 、 执 行 等 整个 
移动 应 用 的 生命 周期 。 针 对 常用 的 Android 自 动 化 测试 框架 和 工具 ， 如 
Appium、Monkey、Robotium 和 UIAutomator 等 都 进行 了 详细 介绍 ， 从 
其 原理 答 析 开始 ， 循 序 渐进 地 介绍 了 其 安装 、 设 置 以 及 API 调 用 等 知 
识 ， 并 围绕 着 实例 详细 介绍 了 其 应 用 实践 、 技 巧 ， 读 者 一 面 看 书 、 
面 实践 ， 就 能 轻松 掌握 Android 自 动 化 测试 的 技能 。 


虽然 是 小 小 的 App 应 用 ， 涉 及 的 技术 却 不 比 棵 面 或 Web 低 ， 反 而 由 
货源 更 军 贯 、 网 络 连 搂 不 稳定 、 迭 代 更 快 、 用 户 体验 要 求 更 高 等 ， 
在 单元 测试 、 性 能 测试 、 庄 力 测试 、 兼 容 性 测试 、 速 度 测 斌 等 各 方面 


都 更 具 挑战 性 ， 测 试 人 员 还 要 面 对 Native、WebView 和 HTML5 等 不 同 
技术 。 本 书 对 上 述 所 有 内 容 ， 包 括 一 些 具体 的 技术 细节 ， 如 非 耦合 式 
用 例 设计 、API 接 口 的 封装 等 ， 都 有 很 好 的 交代 。 书 中 还 提供 了 完整 
的 实例 ， 从 测试 工程 概览 、 签 名 开始 ， 到 测试 用 例 编 写 、 执 行 、 管 
理 ， 再 到 结合 Spoon 生 成 汇总 报告 ， 一 气 呵 成 。 


注重 品质 的 团队 ， 写 起 书 来 也 绝 不 会 忽视 质量 ， 这 本 书 束 是 一 个 
典范 。TMQ 将 书 的 质量 放 在 首位 ， 不 仅 选 择 最 有 经 验 的 测试 工程 师 组 
成 一 文 很 强 的 写作 团队 ， 而 且 初 稿 出 来 之 后 经 过 了 6 轮 的 内 部 评审 ， 参 
加 评审 的 人 员 之 多 、 评 审 时 间 之 长 ， 是 绝无仅有 的 ， 因 此 这 样 写 出 来 
的 书 ， 质 量 是 有 保证 的 。 


本 书 不 仅 介 绍 了 Android 目 动 化 框架 的 基础 知识 、 原 理 和 API 使 
用 ， 而 且 分 析 过 程 逻辑 清楚 ， 设 计 和 实现 思路 清新 目 然 ， 还 触及 一 些 
较 深 的 主题 ， 如 框架 的 二 次 开发 等 ， 故 本 书 适 合 不 同 层次 的 测试 人 员 
和 开发 人 员 学 习 。 借 助 网 站 的 在 线 文 持 ， 本 书 如 虎 添 经 ， 更 加 保证 了 
读者 的 学 习 效 采 。 


综 上 所 述 ， 本 书 是 一 本 值得 网 大 家 推荐 的 好 书 ， 大 家 一 定 会 喜欢 
的 。 有 了 “她 ”， 轻 松 完成 Android 自 动 化 测试 也 就 不 在 话 下 了 。 


为 什么 要 写 这 本 书 


早 在 2010 年 年 底 ， 我 们 团队 束 有 出 一 本 关于 移动 互联 网 测试 书籍 
的 计划 〈 那 时 候 移动 互联 网 测试 书籍 基本 没有 ) ， 当 时 计划 的 内 容 涉 
及 面 比较 广 ， 洱 凋 测 斌 设计、 测试 用 例 管 理 、 测 斌 流程、 目 动 化 测 
试 、 专 项 测试 等 领域 。 不 过 ， 由 于 各 种 原因 被 搁浅 ， 确 实 有 点 儿 可 
惜 ， 否 则 移动 互联 网 测试 国内 的 第 一 本 书 当时 惑 面 世 了 。 这 次 终于 又 
有 机 会 整理 这 些 年 的 测试 经 验 并 形成 一 本 书 了 ， 借 此 可 以 跟 业 界 的 同 
行 一 起 交流 切磋 。 


TMQ (Tencent Mobile Quality) 腾讯 移动 品质 中 心 ， 是 腾讯 内 部 
最 早 专注 于 移动 App 测 试 的 团队 ， 在 10 余 年 的 时 间 内 承担 了 近 10 款 业 
界 领先 产品 的 测试 工作 ， 为 腾讯 向 移动 方向 转型 提供 了 多 项 质量 方案 
和 关键 专利 。 本 书 的 作者 都 是 TMQ 平 台 的 核心 成 员 ， 服 务 于 公司 级 的 
手机 QQ 浏览 器 、 应 用 宝 等 项 目 ， 经 过 这 几 年 在 移动 测试 领域 的 探索 与 
实践 ， 摸 索 出 了 一 些 实 实 在 在 的 实践 经 验 。TMQ 的 老板 鼓励 我 们 把 这 
些 知 识 和 经 验 编写 成 册 ， 这 样 不 仅 能 为 公司 内 部 提供 好 的 产品 服务 ， 
也 能 为 业界 同人 提供 参考 ， 从 而 将 知识 更 好 地 扩散 出 去 。 我 们 团队 非 
常 珍惜 这 次 写 书 的 机 会 ， 故 组 织 了 团队 内 Android 自 动 化 测试 方面 经 验 


丰富 的 同学 一 起 来 编写 。 大 家 都 是 利用 目 己 的 业余 时 间 总 结 各 目 擅长 
领域 的 经 验 和 知识 ， 且 初稿 经 过 6 轮 的 内 部 评审 (参加 评审 的 同事 超过 
人 G2 人 


30 位 ) ， 前 后 历时 半年 多 才 最 终 完成 了 本 书 的 写作 和 修改 ,希望 能 给 
读者 提供 一 本 质量 较 高 的 专业 书籍 。 


TMQ 经 过 这 几 年 的 积 素 ， 在 专项 测试 、 精 准 测试 体系 及 目 动 化 测 
试 方面 都 有 比较 多 的 精辟 之 作 。 基 于 此 ， 我 们 分 小 组 对 这 些 知识 进行 
了 整理 ， 形 成 了 相应 的 知识 库 ， 完 成 了 本 系列 丛书 ， 包 括 《 移 动 互 联 
网 App 性 能 评测 调 优 实践 》《 精 准 化 测试 日 皮 书 》《 腾 讯 Android 目 动 
化 测试 实战 》3 本 书 ， 其 他 两 本 也 在 同期 编写 出 版 工作 中 。 布 望 TMQ 
平台 出 品 的 书籍 能 给 予 读者 思路 上 的 指导 或 者 是 技术 上 的 解 惑 。 


除 封 面 痪 名 外 ， 参 加 本 书 编写 的 作者 还 有 : 陈 航 特 、 陈 六 四 、 邓 
曦 、 高 必 新 、 林 凯 杰 、 刘 洋 、 重 万 林 、 万 宇 、 郑 春 琳 、 钟 书 成 共 12 位 
作者 〈 按 姓氏 拼音 排序 ) ， 都 是 来 日 腾讯 移动 端 QQ 浏览 器 及 应 用 宝 团 
队 的 骨干 员工 。 


读者 对 象 


本 书 是 一 本 务实 的 书籍 ， 案 例 痢 十 作者 们 的 第 一 手 资 料 ， 对 于 软 
件 质量 保证 方面 的 初学 者 ， 本 书 还 提供 了 倘 短 的 案例 以 帮助 其 理解 ， 
循序 渐进 ， 掌 握 测试 核心 原理 ， 对 于 有 经 验 的 同行 ， 本 书 提供 了 经 典 


案例 帮助 其 提升 与 参考 。 这 里 根据 行业 实际 需求 给 出 了 相应 的 用 户 群 
体 : 


-对 移动 业务 测试 感 兴趣 的 人 ; 
-对 Android 目 动 化 测试 感 兴趣 的 人 ; 
即将 开展 Android 目 动 化 测试 的 团队 ; 


-开设 相关 谋 程 的 院 校 师 生 。 


本 书 特色 


Android 目 动 化 测试 经 过 这 几 年 的 发 展 ， 官 方 提供 的 开源 目 动 化 框 
如 已 经 能 非常 好 地 文 持 终端 的 测试 业务 ， 但 是 如 何 利 用 、 如 何 用 好 这 
些 次 源 还 是 比较 现实 客观 的 问题 ， 尤 其 是 在 小 公司 中 ， 目 动 化 测试 方 
法 的 摸索 及 实施 还 存在 一 些 困 难 ， 需 要 一 定 的 投入 才能 得 以 真正 应 
用 。 业 界 一 些 Android 目 动 化 测试 方面 的 书籍 很 多 都 偏 原 理 的 介绍 ， 而 
本 书 不 仅 深度 解析 这 些 框架 的 原理 ， 还 给 出 了 手机 QQ 浏览 釉 、 应 用 掺 
项 目 中 的 典型 案例 ， 像 最 常见 的 App 速 度 、 要 求 较 高 的 视频 播放 性 能 
测试 等 ， 供 需要 实践 的 读者 学 习 ， 这 也 古本 书 的 重要 特色 之 一 。 本 书 
前 半 部 分 主要 介绍 业界 流行 的 Android 自 动 化 框架 的 基础 知识 ， 聚 焦 工 
具 框 架 的 原理 以 及 基础 API 使 用 、 框 染 的 二 次 开发 改造 (根据 具体 项 


目 做 相应 修改 ) ， 以 及 实践 过 程 中 一 些 共性 问题 的 分 享 。 如 果 读 者 已 
经 掌握 这 些 框架 基础 ， 那 么 对 本 书 内 容 的 理解 就 会 更 容易 。 同 时 读者 
可 以 重点 关注 本 书 中 介绍 的 对 框架 进行 二 次 开发 的 内 容 ， 并 结合 自己 
的 实际 项 目 考 虑 如 何 应 用 这 些 知 识 提 升 自己 的 工作 效率 ;基础 比较 高 
的 读者 可 跳 过 这 部 分 直接 阅读 后 半 部 分 。 后 半 部 分 通过 一 些 实际 案例 
来 讲解 目 动 化 框 染 的 应 用 ， 更 强调 系统 性 分 析 设 计 能 力 ， 包 括 需 求 的 
分 析 、 工 具 选 型 、 测 斌 方案、 代码 覆 盖 率 的 应 用 等 ， 履 盖 功 能 测试 、 
性 能 测试 的 具体 实战 案例 。 这 部 分 对 读者 的 技术 能 力 要 求 相对 更 高 一 
些 ， 涉 及 的 知识 点 的 深度 和 广度 要 明显 高 于 前 半 部 分 ， 需 要 进行 
Android App 应 用 的 性 能 速度 测试 的 读者 可 以 深入 阅读 ， 领 会 书 中 所 提 
场景 的 测试 设计 与 思路 ， 进 而 掌握 框架 的 精 体 所 在 。 在 经 典 案例 中 也 
给 出 了 很 多 具体 实现 思路 的 介绍 与 分 析 ， 让 读者 知 其 然 、 并 知 其 所 以 
然 ， 同 时 各 位 作者 也 把 项 目测 试 工程 代码 加 以 整理 ， 打 包 至 TMQ 后 
台 ， 供 读者 下载， 读者 如 有 需要 可 以 直接 导入 工程 进行 调试 学 习 ， 以 
大 大 减少 学 习 成 本 。 读 者 可 以 根据 自己 的 需求 阅读 相应 章节 的 内 容 : 
如 熟悉 Java 语 言 ， 又 面临 Debug 未 混淆 被 测 App 的 情况 ， 建 议 直 接 学 习 
Robotium 框 架 ， 因 为 Robotium 操 作 人 简单 、 相 关 资 料 丰 富 ， 还 能 文 持 
ant、maven 亲 包 ， 与 jenkins 结 合 较 好 ;， 因 Robotium 不 支持 跨 应 用 ， 所 
以 对 于 需要 支持 跨 应 用 的 框架 ， 读 者 可 以 阅读 UIAutomator 和 Appium 
框架 ， 其 中 Appium 是 借助 WebDriver JSON 协 议 实现 的 ， 能 支持 多 种 语 
言 编写 测试 脚本 ， 对 于 有 一 定 经 验 的 读者 ， 在 案例 选择 时 可 以 结合 


Robotium 和 UIAutomator 的 优点 一 起 使 用 ， 此 时 可 直接 阅读 本 书 中 的 浏 
览 絮 视频 性 能 测试 案例 。 


戎 误 和 文 持 


本 书 作者 分 别 在 深圳 、 北 京 、 成 都 、 合 肥 四 地 办 公 ， 所 以 整个 写 
作 过 程 中 异地 沟通 比较 多 ， 整 书 从 选 题 至 初稿 形成 ， 差 不 多 花 了 5 个 月 
的 时 间 ， 速 度 超过 我 们 的 预期 但 由 于 作者 的 水 平 有 限 、 异 地 交流 、 
编写 时 间 仓 促 等 ， 书 中 难免 会 出 现 一 些 错误 或 者 不 准确 的 地 方 ， 晨 请 
读者 批评 指正 。 为 此 ， 我 们 特意 在 TMQ 的 官网 创建 了 一 个 在 线 支 持 : 
http://tmq.qq.com。 你 可 以 将 书 中 的 错误 发 布 在 新 书 勘误 表 页 面 中 ， 我 
们 将 尽量 在 线 上 为 读者 提供 最 满意 的 解答 。 书 中 的 全 部 源 文件 除 可 以 
从 华章 官方 网 站 (http:Wwww.hzbook.com ) 下 载 外 ， 还 可 以 从 TMQ 网 
站 下 载 ， 我 们 也 会 将 相应 的 错误 及 时 更 正 。 如 果 你 有 更 多 的 宝贵 意 
见 ， 也 欢迎 发 送 邮件 至 邮箱 dinahsheng@tencentcom， 期 待 能 够 得 到 你 
们 的 真 汐 反馈 。 


致谢 


感谢 腾讯 科技 MIG 无 发 研发 部 总 经 理 洗 文 佟 、 助 理 总 经 理 陈 诚 ， 
正 征 他 们 训 励 我 们 多 总 结 、 多 分 享 、 把 知识 传播 ， 我 们 才 有 了 写 书 的 
想法 


感谢 腾讯 科技 MIG 无 发 研发 部 品质 中 心 的 总 监 庆 志 、 李 德 广 、 张 
剧 ， 给 我 们 提供 TMQ 这 样 好 的 一 个 人 才 培 养 平台 ， 让 我 们 不 断 成 长 和 
提升 ， 同 时 也 非常 感谢 他 们 在 百 忙 之 中 指导 我 们 写作 。 


感谢 腾讯 科技 的 同事 们 在 整个 写作 过 程 中 ， 帮 我 们 多 次 进行 内 容 
及 技术 层面 的 审核 指 错 ， 盛 其 是 王 琳 同学 ， 作 为 每 章 内 容 的 第 一 位 读 
者 ， 给 了 很 多 好 的 建议 和 思路 ， 其 他 同事 也 对 本 书 的 内 容 进行 了 细致 
的 评审 ， 他 们 是 陆 小 三 、 吴 景 、 柳 炜 、 沈 东 雄 等 ， 在 此 一 并 谢 过 。 


感谢 腾讯 科技 的 浏 宽 占 测 试 团队 、 应 用 宇 测 试 团队 ， 在 我 们 编写 
过 程 中 他 们 提供 的 工作 支持 ， 是 我 们 得 以 这 么 快速 完成 的 基础 。 


感谢 同济 大 学 朱 少 民 教 授 给 我 们 的 专业 指导 和 或 励 ， 让 我 们 更 有 
信心 完成 本 书 的 编写 。 


感谢 机 械 工 业 出 版 社 华章 公司 的 编辑 杨 福 川 、 孙 海 完 ， 是 他 们 多 
次 给 予 我 们 指导 及 或 励 。 


感谢 我 们 的 亲人 在 我 们 周末 加 班 写 作 时 给 予 的 支持 与 理解 ， 你 们 
的 文 持 是 我 们 最 大 的 动力 ! 


齐 以 此 书 献 给 我 们 最 亲爱 的 家 人 ， 以 及 热爱 移动 业务 测试 的 朋友 
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本 如 人 敏 等 


第 1 章 ”概述 


在 展开 各 章节 简介 之 前 ， 本 章 先 带 读 者 了 解 一 下 Android 目 动 化 测 
试 框架 的 大 体 历史 以 及 框架 的 演进 过 程 。Android 自 动 化 测试 框架 和 工 
具 从 2009 年 发 展 至 今日 趋 成 熟 ， 从 早期 官方 提供 的 半自动 化 演进 到 全 
自动 化 框架 ， 包 括 支 持 跨 应 用 、WebView 等 ， 其 功能 越 来 越 强大 ， 并 
融合 库 思 想 、 数 据 驰 动 、 模 块 化 、 画 数 桩 等 先进 的 目 动 化 测试 思想 和 
理念 ，Android 测 试 起 来 越 便捷 。 本 章 主 要 介绍 Android App 目 动 化 框 
架 的 历史 及 热点 问题 。 


1.1 _ Android 目 动 化 测试 框架 概述 


2007 年 Android 开 源 时 ，Monkey、Instrumentation 和 MonkeyRunner 
这 3 个 测试 框架 ， 是 跟 Android 源 码 一 起 发 布 的 ， 这 也 是 最 早 可 用 的 自动 
化 测试 框架 ， 那 几 年 大 家 基本 都 是 用 这 些 框架 来 开展 自动 化 相关 测试 
工作 的 。2010 年 ， 第 一 个 第 三 方 的 测试 工具 Robotium (基于 
Instrumentation) 发 布 了 ， 不 少 测 试 人 员 就 转 用 这 个 框架 ，Robotium 社 
区 逐步 发 展 起 来 。 图 1-1 所 示 为 Roboti um 热度 随 时 间 变 化 的 趋势 。 


2010 年 还 有 一 个 自动 化 测试 框架 Robolectric 开 源 了 ， 主 要 支持 单元 
测试 ，Robolectric 允 许 用 户 做 大 部 分 真实 设备 上 可 以 做 的 事情 ， 且 可 以 
在 浓 规 的 JVM 持 续集 成 环境 中 运行 ， 不 需要 通过 模拟 器 ， 因 此 可 以 摆 
脱 模 拟 句 启动 慢 的 问题 。 


2015 年 7 月 


unRobotium: 52 


图 1-1 Robotium 热 度 随时 间 变 化 的 趋势 


注 : 引用 自 https://www.google.com/trends/explore#q=robotium 


2011 年 新 发 布 的 Android SDK 包 含 了 chimpchat， 可 以 通过 Java 来 调 
用 Monkey， 也 可 以 用 Java 语 言 实现 类 似 MonkeyRunner 功 能 
(MonkeyRunner 之 前 只 支持 Python) 。 


2013 年 则 是 一 个 Android 自 动 化 测试 框架 爆发 年 ，Selendroid、 
Espresso、Calabash、Appium 等 框架 都 是 在 这 一 年 发 布 或 者 开源 的 。 其 
中 ，Appium 整 合 Selendroid 以 及 UI Automator 等 框架 的 优点 ， 使 用 
Selenium 的 WebDriver JSON 协 议 ， 使 WebDriver 用 户 使 用 起 来 非常 方 
便 。 自 2013 年 以 来 ，Appium 发 展 非常 迅速 (不 过 基本 上 是 印度 的 同学 
在 搜索 ) 。 图 1-2 所 示 为 Appium 热 度 随 时 间 变 化 的 趋势 。 


图 1-2 ”Appium 热 度 随 时 间 变 化 的 趋势 


注 : 引用 目 https://www.google.com/trends/explore#q=Appium 


按照 时 间 线 ， 把 上 面 介绍 的 目 动 化 测 弃 框 以 梳理 一 下 ， 如 图 1-3 所 


当然 国内 也 有 不 少 团队 或 者 个 人 开发 自动 化 测试 框架 并 开源 ， 例 
如 百度 的 Café (https://github.com/BaiduQA/Cafe ) ， 阿 里 巴巴 的 两 个 自 
动 化 测试 框架 Athrun (http://code.taobao.org/svn/athrun ) 、Macaca 
(http://macacajs.github.io/macaca/ ) 。 腾 讯 内 部 也 开发 了 Android 自 动 
化 框架 ， 不 过 暂时 没有 开源 。 相 信 国 内 其 他 公司 也 在 开发 相关 自动 化 
框架 ， 有 些 公 司 基于 已 有 的 开源 框架 二 次 开发 定制 适合 自己 项 目的 自 
动 化 框架 ， 可 能 和 暂时 也 没有 开源 。 
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图 1-3 ”Android 自 动 化 测试 框架 时 间 线 


注 : 上 面 提 到 的 是 相对 有 一 定 使 用 人 数 的 自动 化 测试 框架 ， 除 此 
之 外 ， 业 界 还 有 不 少 其 他 测试 框架 ， 如 MonkeyTalk、RoboSpock、 


NativeDriver 等 。 


上 面 简单 介绍 了 Android 自 动 化 测试 框架 的 历史 (时 间 线 展示 ) 。 
Android 自 动 化 测试 里 面 还 涉及 到 一 个 签名 的 问题 (Instrumentation 的 限 


制 ) ， 我 们 按照 重 签名 的 维度 重新 划分 一 下 ， 方 便 读 者 做 目 动 化 测试 
框架 的 选 型 。 图 1-4 所 示 为 Android 自 动 化 测试 框架 图 谱 ， 仅 供 参考 。 


Android 自动 化 测试 框架 图 谱 
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pi JavaMonkey: Roboectric http//pvotalgithub.com/robolectric/ 
i httpy/dtmilano blogspot.com/2011/11/android-using-monkey-from-java html & 
https//gaogle github io/android-testing-support-ibrary/docs/espresso/index html 
Record&Replay Calabashr 


http//code lardcave net/entries/2009/08/01/160953/ https//github,com/calabash/calabash-android 


图 1-4 Android 目 动 化 测试 框架 图 谱 
注 : Appium 不 需要 更 改 被 测 App 签 名 ; 
Hybrid: 混合 Android 原 生 控 件 以 及 Webview 控 件 ; 


Native: 纯 Android 原 生 控 件 。 


1.2 ”本 书 内 容 概述 


本 书 主要 介绍 Android 自 动 化 测试 相关 内 容 ， 分 为 以 下 两 大 部 分 。 


第 一 部 分 介绍 业界 流行 的 Android 自 动 化 框架 的 基础 知识 ， 聚 焦 工 
具 框 架 的 原理 和 基础 API 使 用 ， 以 及 框架 的 二 次 开发 (根据 具体 项 目 
做 相应 修改 ) ， 分 享 实践 过 程 中 的 一 些 共 性 问题 。 这 部 分 内 容 需 要 读 
者 有 基本 编程 能 力 (主要 是 Java 方 面 的 编程 基础 ) ， 如 果 读 者 已 经 具 
有 这 方面 的 能 力 (比如 独立 按 Android 开 发 者 官网 文档 搭建 相关 
Helloworld 的 工程 ) ， 那 就 更 容易 理解 书本 的 内 容 ， 同 时 可 以 重点 关 
注 如 何 进 行 二 次 开发 ， 以 及 如 何 应 用 于 实际 项 目 。 


第 二 部 分 通过 一 些 实际 案例 来 讲解 这 些 目 动 化 框架 的 应 用 ， 更 强 
调 系 统 性 分 析 设 计 ， 包 括 需 求 的 分 析 、 工 具 先 型、 代码 窗 盖 率 的 应 
用 ， 以 及 和 窗 蓄 功能 测试 以 及 性 能 测试 的 具体 实战 等 。 这 部 分 对 读者 的 
技术 能 力 要 求 相 对 更 高 一 些 ， 涉 及 的 知识 点 会 多 一 些 。 当 然 如 果 有 不 
太 明 昌 的 地 方 ， 欢 迎 与 各 章节 的 作者 进行 交流 。 


第 一 部 分 Android 目 动 化 测试 基础 篇 。 


本 书 第 一 部 分 内 容 驶 是 从 目 动 化 框 洪 图 谐 中 选择 业界 相对 流行 的 
自动 化 测试 框架 展开 介绍 ， 根 据 Google 上 这 些 自动 化 测试 框架 搜索 量 
以 及 我 们 了 解 到 的 各 互联 网 公司 的 目 动 化 框架 使 用 情况 ， 我 们 远 择 有 


代表 性 的 4 个 框架 (Monkey、Robtotium、UI Automator) Appium) 分 


别 进行 介绍 。 第 1 草 也 即 本 草 ， 所 以 从 第 2 章 开始 简介 。 


第 2 革 目 动 化 测试 框架 及 应 用 领域 绿 述 ， 本 章 通 过 一 个 浅显 易 慌 的 
Android 目 动 化 测试 案例 进行 详细 讲解 ， 提 炼 出 通用 的 自动 化 测试 框架 
的 原型 一 一 “动作 执行 /结果 判断 /报告 展示 ”， 最 后 介绍 目 动 化 测试 的 各 
种 应 用 场景 ， 方 便 读 者 更 好 地 应 用 目 动 化 测试 。 


第 3 草 Robotium 框 以 工作 原理 及 实践 : 本 章 要求 读 者 有 一 定 的 
Robotium 基 础 ， 可 以 移 到 Robotium 官 网 下 载 相关 Robotium 的 基础 Demo 
练习 。 第 一 节 移 简单 介绍 Robotium 的 特点 以 及 优 缺 点 ， 再 到 Robotium 
主要 API 的 详解 ， 对 Native 探 件 以 及 Webview 探 件 分 别 从 获取 以 及 相关 
操作 展开 介绍 ， 同 时 还 有 不 少 实践 过 程 中 技巧 的 分 享 ， 例 如 搜索 以 及 
等 得 时 间 、 堆 图、 断言 等 。 第 二 节 深 入 Robotium 的 代码 框架 ， 结 合 代 
码 分 析 ， 分 别 介绍 控件 获取 以 及 操作 的 具体 实现 原理 ， 针 对 最 近 叉 流 
行 起 来 的 H5 页 面 ， 着 重 介 绍 Webview 的 基本 原理 ， 方 便 读者 对 H5 页 面 
进行 测试 。 第 三 节 通 过 分 享 3 个 实际 案例 (都 是 测试 人 员 会 经 常 磁 到 的 
案例 ) ， 方 便 读者 处 理 类 似 问题 。 第 一 个 案例 是 解决 相同 ID 或 者 没有 
ID 的 控件 ， 第 二 个 案例 是 对 ListView 在 屏幕 之 外 操作 技巧 ， 第 三 个 案 
例 则 是 针对 一 些 定制 化 的 Webview (例如 腾讯 浏览 器 服务 
X5Webview) 进行 适 配 ， 让 Robotium 也 能 快速 支持 定制 化 Webview 的 
自动 化 测试 。 


第 4 章 Monkey 基 本 原理 及 扩展 应 用 : 每 个 从 事 过 Android App 测 试 
的 同学 都 应 该 使 用 过 Monkey 工 具 。Monkey 工 具 也 是 最 基础 的 自动 化 
工具 之 一 ， 上 手 比较 容易 ， 因 此 基本 是 大 家 的 首选 。 本 章 第 一 节 从 
Monkey 基 础 知识 开始 介绍 ， 从 参数 配置 到 环境 搭建 做 基本 解读 ， 让 读 
者 能 够 通过 本 小 节 启 动 自己 的 Monkey 自 动 化 测试 。 第 二 节 通 过 测试 实 
例 讲解 Monkey 具 体 使 用 ， 以 及 使 用 Monkey 发 现 crash 后 产生 日 志 的 统 
计 分 析 ， 解 决 实际 测试 过 程 中 的 一 些 问题 ， 让 读者 能 结合 自己 的 项 目 
做 Monkey 目 动 化 测试 。 第 三 节 通 过 Monkey 的 源码 来 介绍 Monkey 的 代 
码 基 本 框架 以 及 某 些 多 辑 详 解 ， 让 读者 清楚 地 了 解 Monkey 运 行 逻辑 

〈 需 要 用 户 有 相关 Java 代 码 基础 ) ， 使 得 读者 “ 知 其 然 更 知 其 所 以 

然 ”。Monkey 提 供 的 功能 可 能 没 法 满足 要 求 ， 我 们 需要 通过 对 Monkey 
的 二 次 开发 来 定制 需求 ， 第 四 市 通过 两 个 实际 案例 来 详细 介绍 Monkey 
的 二 次 开发 过 程 ， 这 样 就 方便 读者 动手 二 次 开发 自己 的 需求 。 


第 5 章 UI Automator 框 架 及 实践 : 本 章 第 一 节 先 简单 介绍 UI 
Automator 的 发 展 历程 以 及 特点 ， 让 读者 有 一 个 基本 认识 。 第 二 市 介绍 
UI Automator 整 体 框架 、UI Automator 各 个 类 以 及 它们 之 间 的 关系 ， 然 
后 重点 介绍 五 大 基础 类 UiDevice、UiSelector、UiObject、 
UiCollection、UiScrollable。 接 下 来 重点 介绍 该 框架 两 个 重要 事情 一 一 
界面 解析 和 事件 注入 ， 通 过 代码 解读 这 两 块 的 基本 原理 。 最 后 把 API 
都 注解 一 下 ， 方 便 读 者 查询 。 第 三 方 主要 通过 实战 案例 来 展示 UI 
Automator 的 使 用 ， 从 功能 测试 到 性 能 测试 以 及 压力 测试 都 有 相关 案例 


讲解 ， 基 本 测试 类 型 目 动 化 都 可 以 选择 UI Automator 来 完成 ;同时 总 
结 使 用 过 程 中 的 问题 ， 如 输入 法 、 第 三 方 包 编译 、adb 稳 定性 等 问题 ， 
方便 读者 借鉴 思路 。 


第 6 章 Appium 框 架 解 析 及 实践 : 本 章 第 一 节 介 绍 Appium 基 本 架构 
原理 以 及 使 用 到 的 一 些 技术 点 ， 同 时 说 明 Appium 框 架 的 优 缺 点 ， 让 读 
者 有 一 个 大 概 认识 ， 方 便 做 自动 化 测试 框架 选择 。 第 二 节 从 环境 搭建 
入 手 ， 手 把 手 教 读者 完成 一 个 HellowWorld 的 测试 示例 ， 接 下 来 针对 日 
常 可 能 用 到 的 方法 对 API 进 行 解读 ， 让 读者 逐步 上 手 。 第 三 节 开 始 介 
绍 自动 化 测试 一 些 进 阶 思路 ， 例 如 接口 封装 以 及 用 例 设计 思想 ， 引 导 
读者 把 自动 化 测试 做 得 更 好 。 接 下 来 以 腾讯 地 图 自动 化 测试 实践 为 案 
例 ， 分 别 从 可 重复 性 、 稳 定性 和 可 维护 性 三 个 方面 详细 介绍 ， 同 时 对 
Hybrid App 测 试 做 了 介绍 ， 最 后 对 Appium 实 践 过 程 中 常见 问题 做 了 解 
答 ， 方 便 读 者 借鉴 ， 避 免 走 弯路 。 


第 二 部 分 Android 目 动 化 测试 实战 篇 


第 7 章 Android App 速 度 测 试 : 本章 选 择 对 用 户 体验 感知 明显 的 一 
个 性 能 点 一 一 App 速 度 ， 针 对 App 速 度 测试 来 进行 深度 分 析 ， 从 整个 需 
求 的 系统 分 析 ， 再 到 详细 对 比 不 同 速度 测试 方法 ( 拘 秒 表 、 打 Log、 
录像 、Hook 方 式 、 网 络 包 分 析 等 ，， 最 后 提炼 出 速度 测试 的 相关 方法 


论 ， 以 供 读者 参考 。 


第 8 章 视 频 性 能 测试 案例 : 本 章 选 择 视频 性 能 这 个 需求 进行 系统 性 
分 析 ， 从 用 户 感知 层面 出 发 ， 挖 掘 相 关 需 求 点 ， 再 到 整体 性 能 方案 的 
设计 (从 自动 化 执行 以 及 结果 对 比 等 都 做 详尽 的 分 析 ) ， 最 后 到 结果 
分 析 等 方面 ， 都 做 了 系统 性 详细 介绍 ， 给 读者 一 个 完整 的 案例 。 这 一 
章 对 读者 基础 能 力 要求 有 点 儿 高 ， 除 了 涉及 Java 编 程 语言 ， 还 涉及 C 的 
编程 (JNI) ， 同 时 要 求 在 视频 方面 有 一 定 的 基础 (如 FFMPEG) 。 


第 9 章 应 用 宝 BVT 测 试 方案 : Robotium 在 应 用 宝 项 目的 实践 案例 。 
主要 介绍 如 何 利 用 Robotium 来 做 BVT (Build Verification Test) ， 把 
App 最 基础 功能 梳理 出 来 ， 然 后 写成 目 动 化 测试 用 例 ， 每 次 持续 集成 
编译 成 功 ， 都 会 运行 这 些 自动 化 脚本 ， 确 保 每 个 版 本 基础 功能 可 用 。 
同时 结合 代码 覆盖 率 ， 可 以 关注 禾 盖 度 情 况 。 代 码 履 盖 率 主要 用 
JaCoCo 生 成 ， 当 然 Emma 也 使 用 很 广泛 。 


第 10 章 兼容 性 测试 实践 : Android 手 机 从 2007 年 发 布 ， 到 目前 为 
止 ， 有 超过 2000 种 型 号 ， 系 统 从 2.X 到 6.X，Android 碎 片 化 比较 严重 ， 
那么 怎么 保证 App 在 大 多 数 的 机 型 系统 中 正常 运行 呢 ? 这 一 章 介绍 如 
何 利 用 业界 的 云 测试 系统 进行 测试 。 云 测试 系统 包括 百度 MTC、 
Testin、 优 测 ， 通 过 使 用 这 些 云 测试 系统 可 以 快速 发 现 一 些 兼容 性 问 


题 。 


第 2 章 ” 目 动 化 测试 框 染 及 应 用 领域 织 述 


近 几 年 ， 随 着 移动 互联 网 的 快速 发 展 ， 智 能 终端 的 App 应 用 越 来 越 
广 ，Android 测 试 技术 也 备 受 重视 ， 新 的 终端 目 动 化 测试 框架 层 出 不 
穷 ， 本 章 笔 者 就 目 动 化 测试 的 入 门 知 识 及 其 应 用 做 一 个 浅显 的 梳理 与 
总 结 ， 与 谈 着 一 同 探讨 移动 终端 目 动 化 测试 思路 和 方案 。 同 时 ， 本 书 
主要 也 是 围绕 本 章节 提 到 的 基础 框架 及 其 应 用 场景 进行 实战 分 析 与 演 
练 ， 以 亲身 体验 总 结 出 实际 项 目 经 验 ， 给 准备 实施 或 正在 实施 自动 化 
测试 的 读者 提供 一 些 帮 助 和 建议 。 


自动 化 测试 在 软件 测试 的 各 大 沙龙 、 行 业 峰 会 以 及 培训 课程 中 都 
是 一 个 热门 的 话题 ， 很 多 测试 人 员 也 非常 热衷 于 目 动 化 前 脆 知 识 的 研 
究 和 学 习 。 那 么 Android 自 动 化 测试 框架 如 何 理解 和 定义 呢 ? 每 个 人 给 
出 的 答案 不 一 定 完全 一 样 ， 笔 者 认为 ， 狭 义 上 就 是 通常 说 起 的 自动 化 
测试 框架 ， 像 很 早 就 风靡 的 Robotium、 后 起 之 秀 UI Automator、 跨 平台 
的 Appium 以 及 类 似 于 Monkey 的 稳定 性 工具 等 ， 广 义 上 包括 目 动 化 测试 
框架 和 测试 管理 平台 ， 前 者 通用 于 狭义 概念 上 的 理解 ， 后 者 主要 是 测 
试 中 对 测 斌 用例、 执行、 资源 调度 、 问 题 提 单 、 数 据 统 一 存储 、 报 告 
输出 等 进行 综合 的 展示 平台 。 本 书 主要 介绍 基于 狭义 定义 的 自动 化 实 
践 ， 本 章 知 识 结 构图 如 图 2-1 所 示 。 


简单 的 Android App 自动 化 测试 过 程 
| 


动作 执行 
te 
结果 显示 


性 能 测试 一 关键 路 径 的 性 能 测试 
稳定 性 测试 一 Crash/ANR 等 问题 的 测试 
Android 自动 化 测试 基础 知识 功能 测试 一 BVT 等 常用 核心 功能 点 测试 
应 用 场景 一 -兼容 性 测试 一 模型、 网络 、OS 等 测试 
接口 测试 一 APLTJS API 等 接口 测试 
单元 测试 
线 上 监控 测试 一 线 上 监控 及 问题 自动 化 验证 闭环 


总 结 


图 2-1 ”本章 知 识 结构 图 


2.1 有 目 动 化 测试 框 以 介绍 
2.1.1 一 个 人 简单 的 Android App 目 动 化 测试 过 程 


在 了 解 相 关 的 Android App 的 目 动 化 测试 框 染 之 前 ， 先 来 看 一 个 第 
用 的 目 动 化 测试 实例 ， 这 里 先 不 讨论 框架 ， 主 要 是 测试 用 户 操 作 的 模 
拟 、 执 行 结果 的 判断 ， 以 便 获 得 对 测试 目 动 化 的 感性 认识 。 


案例 需求 如 下 : QQ 浏览 器 打开 手机 存储 卡 的 文件 ， 通 过 上 自动 化 测 
试 获取 其 打开 某 一 文件 的 响应 时 间 ， 这 里 首先 需要 做 细 分 ， 把 需求 拆 
分 为 几 个 关键 点 ， 即 进入 浏览 器 、 文 件 打 开 操 作 、 获 取 手 机 屏幕 、 截 
图 分 析 、 结 果 统 计 输 出 。 自动化 测试 就 是 实现 机 器 完成 这 些 关键 点 的 
一 系列 操作 ， 并 且 在 脚本 的 实际 运行 中 添加 需要 的 业务 逻辑 判断 ， 实 
现 测试 自动 化 。 根 据 脚 本 的 具体 实现 ， 整 理 出 打开 文件 测试 流程 图 ， 
如 图 2-2 所 示 。 


文件 打开 录制 模块 


| 


波 测 文档 库 | | 


| | 


测试 逻辑 驱动 (UI) 


被 屏 (快速 截屏 ) 
| 
Ey 


图 片 分 析 模 块 


图 2-2 ”打开 文件 测试 流程 图 
1. 准 备 测试 工具 


下 载 record 和 replay 的 脚本 录制 工具 ， 有 很 多 工具 可 以 实现 ， 比 如 
本 书 中 的 MonkeyRunner、UIAutomator 等 ， 在 这 个 案例 里 从 网 上 下 载 
record/replay 可 执行 工具 ， 直 接 复 制 至 手机 硬盘 。 


2. 了 采制 测试 脚本 


在 PC 上 连接 手机 ， 打 开 adb shell 命 令 ， 进 入 record 工 具 存 放 目 录 ， 
用 shell 命 令 运行 record 工 具 启 动用 户 脚 本 录制 ， 并 给 录制 命名 ， 如 wps 
(打开 wps 文 件 ) 。 工 具 运 行 成 功 之 后 ， 手 工 完成 所 需要 的 业务 操作 
(如 手机 主页 一 选择 QQ 浏览 器 一 文件 目录 一 双击 wps 文 件 ” ， 操 作 结 
束 后 ， 按 Ctrlt+C 键 结束 脚本 的 录制 工作 。 录 制 脚本 过 程 如 图 2-3 所 示 。 


IDD:\>adp shell /data/local/tmp/record enter wps 


check TT directory:@... 


图 2-3 ”和 采 制 脚 本 过 程 


3. 执 行 测试 脚本 


这 里 以 Java 语 言 进行 测试 脚本 的 编写 作为 示范 ， 通 过 Java 的 
ProcessBuilder 类 在 PC 上 创造 并 启动 一 个 cmd 命 令 行 的 进程 ， 并 执 
行 “adb shell replay” 操 作 进 行 脚本 回放 ， 这 样 打开 文件 的 功能 就 可 以 通 
过 脚本 完成 相应 的 操作 执行 ， 如 代码 清单 2-1 所 示 。 


代码 清单 2-1 实现 浏览 器 中 打开 wps 文 件 


public static synchronized void enterWwPSs() 


ProcessBuilder pb = new 
ProcessBuilder("cmd.exe");//ProcessBuilder("/system/bin/sh"); 

// java.lang.ProcessBuilder: Creates operating System processes. 
pb.directory(new File("C:\\")); 

// 设置 


She1J] 的 当前 目录 。 


try { 
Process proc = pb.start(); 


BufferedReader in = new BufferedReader (new 
InputStreamReader(proc.,getInputStream( ) ) ) ， 
// 获取 输入 流 ， 可 以 通过 它 获 取 


SHELL 的 输出 。 


BufferedReader err = new BufferedReader (new 
InputStreamReader(proc.,getErrorStream( ) ) ) ， 

Printwriter out = new Printwriter(new Bufferedwriter(new OutputStreamWwriter 
(proc.getOoutputStream())), true); 

// 获取 输出 流 ， 可 以 通过 它 向 


SHELL 发 送 命 令 。 


out.println("adb shell replay enter wps"); 
// 打 开 
WPS 文 件 


out.println("exit"); 
String line; 


while ((line = in.readLine()) != nul]l) 
{ 

System.out.println(line),; 
while ((line = err.readLine()) != null) 
{ 


System,.out.println(line); 
} 
in.close(); 
out.close( ); 
proc.destroy(); 


} 
catch (Exception e) 
{ 
System.out.println("exception:" + e); 
} 
} 
} 


这 里 的 录制 脚本 存放 路 径 需 要 读者 在 实践 时 进行 更 改 ， 或 者 把 录 
制 的 脚本 放置 在 /system/bin/。 


4. 结 果 判 断 


这 里 通过 测试 脚本 完成 了 用 户 操 作 的 模拟 实现 ， 但 古 正常 的 测试 
还 需要 结 末 的 验证 ， 需 要 编码 脚本 进行 测试 结果 的 判断 ， 本 案例 可 以 
通过 截屏 和 图 片 分 析 wps 文 件 是 否 打开 成 功 ， 可 以 通过 Google 汉 明 距 
离 相似 度 对 比 算法 得 到 图 片 相似 度 来 判定 打开 的 结果， 代码 相 对 要 复 
杂 一 些 ， 后 面 的 案例 中 也 有 类 似 的 代码 实现 ， 这 里 束 不 表 细 壕 。 


2.1.2 ” 目 动 化 测试 框架 基本 原理 


经 过 前 面 的 一 个 简单 的 目 动 化 测试 案例 ， 我 们 对 Android 的 目 动 化 
测试 有 了 一 个 感性 的 认识 ， 很 多 有 相关 工作 经 答 的 测试 同学 也 都 会 理 
解 ， 这 和 PC 的 目 动 化 测试 思路 是 相通 的 ， 只 不 过 所 借助 的 框架 不 同 ， 
目前 业界 已 经 有 很 多 成 熟 的 开源 Android 端 自动 化 测试 框架 ， 经 常用 到 
的 框架 代表 有 Robotium 和 UI Automator， 各 个 框架 可 能 在 具体 应 用 上 
有 些 不 同 ， 如 有 些 偏 稳 定性 ， 有 些 适 用 于 Web 应 用 ， 有 些 能 文 持 跨 应 
用 ， 等 等 ,但 其 主要 思想 是 通过 控件 的 位 置 、 名 称 、 属 性 等 获取 控件 
对 象 ， 并 且 对 控件 对 象 或 者 坐标 模拟 用 户 操作 ， 测 试 同学 通过 这 些 控 
件 的 操作 和 状态 变化 来 完成 目 动 化 测试 的 执行 。 图 2-4 里 罗列 了 目前 背 
用 的 测试 框架 ， 也 是 本 书 中 实践 的 重点 ， 后 面 的 章节 会 详细 讨论 这 些 
框架 的 原理 及 应 用 。 
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图 2-4 目前 常用 的 测试 框 染 


这 一 小 节 讨 论 的 目 动 化 测试 框架 ， 是 在 实际 项 目 中 总 结 出 来 的 且 
基本 能 运行 的 通用 基础 框架 原型 ， 它 包括 三 个 核心 部 分 : 一 是 如 何 获 
取 坐 标 / 控 件 并 操作 控件 模拟 用 户 端 事件 ， 二 是 脚本 中 的 结果 如 何 判 
断 ， 三 是 测 弃 结 有 果 报 告 的 输出 与 展示 。 不 管 测试 人 员 使 用 的 是 
Robotium 还 古 其 他 框架 ， 万 变 不 离 其 永 ， 通 用 原理 都 可 直接 图 解 为 图 
2-5 所 示 的 这 几 个 模块 。 


跨 应 用 / 跨 进程 


ee a 


六 和 
/ 
Ee \ 严 站 nm 
1 截图 ' 结果 汇总 
! 控件 1 智能 预警 


和 


控件 


‘ 
% ‘ 、 / 
/ 7 
机 z 7 


2-5 Android 目 动 化 测试 基本 框架 模块 
1. 动 作 执 行 


目 动 化 测试 的 首要 条 件 是 能 够 操作 控件 ， 最 好 像 开发 同学 一 样 操 
作 控 件 ， 如 何 实 现 呢 ? 一 种 最 第 见 的 脚本 录制 方法 ， 其 主要 思想 是 记 
录 控 件 的 坐标 位 置 和 发 生 的 事件 ， 通 过 回放 脚本 完成 测试 事件 流 ， 像 
Monkey Runner 框 架 束 提供 比较 方便 的 录制 回放 功能 ， 男 一 种 方法 束 古 
通过 工具 (比如 : 源码 、UIAutomatorviewer 等 ) 获得 测试 界面 的 控件 


布局 ， 找 到 目标 空间 的 ID、 和 名字、 描述 或 者 位 置信 息 。 测 试 框架 可 以 
通过 这 些 信息 得 到 控件 对 象 ， 并 对 控件 对 象 执 行 一 系列 事件 操作 像 
Robotium、UIAutomater 等 ， 这 个 阶段 理解 为 测试 的 动作 执行 。 


当然 对 于 有 跨 应 用 App 的 控件 操作 会 受到 Android 进 程 安全 限制 ， 

这 对 于 跨 应 用 的 操作 是 一 个 难点 ， 举 个 简单 的 跨 应 用 例子 ， 在 测试 一 
款 App 应 用 时 ， 它 的 某 个 功能 会 调 起 系统 相机 拍照 ， 那 这 个 功能 就 会 
涉及 路 应 用 了 “。 像 Robotium 惑 无 法 调用 系统 的 一 些 INPUT 事 件 完成 跨 
应 用 的 控件 操作 (其 实 Robotium 从 Android 4.3 之 后 开始 支持 
UIAutomation 框 架 ， 理 应 可 以 支持 跨 应 用 的 ) ， 基 于 Robotium 框 架 的 
测试 脚本 跟 被 测 对 象 需 在 同一 个 App 或 者 可 以 相互 访问 ， 一 般 要 求 重 
新 签名 打包 。 上 所 以 在 选 定 框 架 时 就 需要 考虑 相关 的 权限 问题 ， 当 前 可 
以 直接 支持 跨 应 用 的 框架 有 MonkeyRunner、UIAutomater 等 ， 后 面 的 
章节 会 详细 给 出 主流 框架 的 分 析 和 使 用 建议 ， 这 里 不 再 细 述 。 


2. 结 果 判 断 


目 动 化 测试 中 非常 重要 的 一 个 环节 台 是 测 弃 步 又 的 验证 ， 如 何 能 
不 进行 人 工 干涉 而 去 正确 并 且 目 动 地 检查 验证 点 ， 这 是 目 动 化 测试 环 
广 中 的 一 个 关键 点 ， 有 些 可 以 借助 测试 框 染 的 截图 对 比 〈 像 
MonkeyRunner) 直接 完成 结果 输出 ， 但 在 实际 项 目 中 会 有 很 多 具体 业 
务 ， 验 证 点 会 比较 困难 ， 不 同 的 案例 可 以 用 拆 解 和 辅助 的 验证 方式 来 


完成 。 比 如 播放 右 播 放 视 频 时 ， 如 何 验 证 视频 播放 成 功 ， 这 里 整 需 要 
设 定 很 多 验证 点 。 若 播放 的 时 间 >0， 可 以 直接 获取 video 标 签 里 的 
current time 来 判断 ;若是 功能 测试 ， 则 有 两 种 情况 : 人 播放 时 有 画 
面 ， 可 以 直接 截屏 获取 ;CGO 播放 时 有 声音 ， 可 以 获取 声卡 捕捉 声音 的 
数据 ， 分 析 波 形 文件 ， 但 实现 起 来 难度 束 比 较 大 ， 后 面 的 革 广 中 有 具 
体 的 案例 介绍 。 基 本 结果 验证 的 方法 概括 如 下 。 


(1) 截图 对 比 。 对 于 GUI 的 测试 ， 一 般 会 采用 截图 方式 ， 但 最 简 
单 的 截图 也 需要 考虑 到 很 多 附带 的 条 件 ， 大 部 分 框架 会 有 此 功能 ( 没 
有 的 话 也 不 要 暴 ， 可 以 直接 用 系统 目 融 的 screencap 或 者 其 他 工具 配合 
使 用 ， 但 它 每 秒 能 截取 多 少 张 图 片 ? 能 否 满足 我 们 需要 的 图 片 判断 
条 件 ? 截取 的 图 片 如 何 做 对 比 ， 对 比 的 参照 物 是 什么 ? 做 性 能 测试 
时 ， 我 们 的 工具 是 否 会 影响 性 能 ?要 不 要 选择 扣 照 工具 而 不 影响 性 
E? 获取 图 片 的 速度 能 否 满 足 性 能 测试 要 求 ? 对 比 的 参照 物 又 如 何 设 
? 这 些 信息 在 每 个 具体 的 案例 中 叉 会 衍生 一 系列 新 的 问题 。 束 一 个 
体 的 案例 来 说 ， 浏 览 絮 打开 网 页 的 目 字 啊 应 时 间 测 试 中 ， 对 比 参照 
物 可 以 是 一 张 空 日 的 图 片 ， 把 指定 的 像素 区 域 与 这 张 空 日 图 片 做 对 比 
号 能 判定 结果 ;而 浏 咒 器 播放 视频 时 的 啊 应 时 间 测 试 时 所 截取 的 图 
片 ， 束 不 能 这 样 判断 ， 因 为 很 多 视频 会 在 播放 之 前 束 显 示 一 个 关键 帕 
的 图 片 。 为 什么 会 这 样 ? 本 书后 面 的 章 市 会 针对 一 些 典 型 业务 进行 由 
浅 入 深 的 案例 分 析 与 工具 设计 ， 会 用 到 基本 框 砍 但 不 局 限于 此 ， 还 需 


多 所 起 


\ 


要 测试 人 员 更 多 的 对 工具 和 框架 的 配合 应 用 与 改造 能 力 ， 完 成 系统 性 
的 业务 测试 需求 。 


(2) 控件 对 比 。Android UI 自动 化 测试 最 直接 面 对 的 是 应 用 程序 
界面 ， 界面 上 存在 按钮 (button) 、 文 本 框 (textView) 等 ， 我 们 都 称 
之 为 控件 。 有 些 应 用 程序 的 执行 逻辑 直接 体现 在 控件 的 状态 显示 上 ， 
如 按钮 状态 的 变化 、 文 本 的 改变 等 。 常 用 的 目 动 化 测试 工具 Robotium 
和 UI Automator 都 提供 了 获取 应 用 控件 的 接口 ， 当 执行 完 一 定 的 目 动 
化 测试 逻辑 后 ， 可 以 将 获取 控件 上 的 信息 与 预期 的 信息 进行 对 比 ， 判 
断 测试 结 宁 征 否 通过 。 比 如 测试 一 个 计算 夯 程 序 ， 执 行 3 乘 以 5 的 测试 
用 例 后 ， 可 以 在 结果 输出 框 得 到 输出 的 值 (result) ， 用 框架 的 结果 与 
预期 的 结果 做 对 比 : assertEqual (result，15) ， 判 断 这 个 测试 用 例 的 


结果 是 否 通过 。 


(3) 日 志 分 析 。 日 志 分 析 可 以 作为 一 个 辅助 结果 判断 ， 比 较 适 合 
在 集成 测试 阶段 做 的 一 些 接口 、 稳 定性 和 性 能 测试 ， 因 为 这 个 阶段 产 
品 的 日 志 一 般 处 于 打开 状态 ， 测 试 同学 可 以 很 方便 地 收集 到 日 志 关 键 
字 信息 。 比 如 在 进行 稳定 性 测试 时 ， 可 以 直接 把 所 有 日 志 输 出 至 文 
件 ， 在 测试 执行 程序 中 加 入 简单 的 文本 处 理 ， 对 日 志 信 息 进 行 分 类 检 
索 ， 像 在 Java 层 出 现 crash 时 ， 可 以 搜索 日 志 中 的 FATA 
EXCEPTION/ANR 等 关键 字 ， 提 取 后 面 的 儿 十 行 日 志 信 息 进 行 第 选 处 
理 。 日 志 使 用 的 更 高 进 阶 是 日 志 埋 点 ， 对 需要 测试 的 接口 坦 入 上 报信 


息 ， 一 旦 测试 执行 〈 用 户 使 用 ) 到 该 点 ， 启 动 上 报 接 口 (或 者 SDK) 
送 至 指定 的 路 径 ， 就 可 以 直接 准确 地 看 到 测试 结果 ， 一 般 在 灰 度 发 布 
后 这 些 日 志 信息 会 被 关闭 ， 总 体 上 不 会 影响 产品 的 功能 。 但 日 志 的 使 
用 也 有 一 些 局 限 性 ， 比 如 测试 同学 对 日 志 tag 不 熟悉 ， 需 要 先 了 解 代码 
信息 等 ， 还 有 竞 品 对 比 测试 时 因为 拿 到 的 竞 品 包 都 是 混淆 的 正式 发 布 
包 ， 没 有 关键 日 志 信息 输出 ， 可 能 需要 用 其 他 的 手段 来 判断 结果 ， 比 
如 控件 对 比 〈 当 然 高 手 例外 ， 他 们 可 能 会 使 用 逆向 工程 ， 反 编译 再 注 
入 需要 的 log) 


3. 报 告 展示 


报告 展示 一 般 是 指 给 出 整个 测试 的 结果 信息 汇总 并 进行 简单 的 分 
析 ， 测 试 结束 后 直接 输出 预警 和 初步 的 数据 报告 ， 以 邮件 或 者 其 他 形 
式 直 接 周 知 项 目 参 邱 人 员 。 如 采 执 行 较 大 的 项 目测 试 ， 束 可 能 需要 多 
维度 、 多 指标 地 对 答 测 应 用 的 测试 数据 进行 整合 ， 要 求 测试 同学 对 平 
人 台 有 较 高 的 设计 能 力 ， 比 如 平台 需要 实现 产品 中 核心 业务 的 性 能 
benchmark 测 试 结果 及 分 析 ，BVT (Build Verify Testing) 测试 中 发 现 
的 问题 预警 ， 功 能 目 动 化 测试 脚本 中 的 BUG 目 动 提单 ， 等 等 。 有 些 目 
动 化 测试 框架 里 也 带 有 简单 的 测试 管理 平台 ， 根 据 业务 类 型 决定 这 些 
平台 是 否 能 满足 需求 ， 有 的 产品 需要 平台 文 持 多 业务 的 横向 与 纵 同 对 
比 信 息 、 竞 品 的 评分 信息 等 ， 这 时 就 需要 做 二 次 开发 ， 形 成 一 个 系统 


性 的 测试 管理 工具 ， 也 即 前 文中 说 的 测试 的 管理 乎 人 台 框 以。 


22 移动 终端 自动 化 测试 应 用 场景 


移动 应 用 的 特点 是 快速 欠 代 、 快 速 发 布 ， 基 于 移动 应 用 的 测试 束 
逐渐 转变 为 轻 量 测试 、 灰 度 发 布 机 制 、 众 测 、 后 台 云 控 系 统 等 ， 甚 至 
有 损 发 布 ， 很 多 类 似 的 产品 不 断 涌 现 ， 随 着 市 场 和 用 户 日 趋 成 熟 ， 产 
品 的 功能 蕾 异 性 不 大 ， 那 么 苋 争 的 天 键 束 转移 至 品质 与 口碑 ， 就 要 求 
研发 团队 严 把 质量 关卡 ， 赢 得 用 户口 碑 。 在 这 样 的 前 提 下 ， 需 要 在 质 
量 团 队 引 入 更 强大 的 平台 或 者 用 测试 方法 文 撑 业 务 的 品质 ， 要 求 目 动 
化 测试 的 思路 深入 至 品质 的 各 个 角落 ， 以 真正 为 产品 质量 服务 。 


不 妨 梳理 一 下 在 应 用 App 测 试 的 时 候 ， 需 要 在 哪些 耗 时 耗 力 以 及 特 
殊 要 来 的 场景 进行 目 动 化 测试 。 读 者 首先 可 能 会 想到 兼容 性 测试 ， 因 
为 众所周知 的 Android 雄 片 化 问题 ， 不 同 的 机 型 适 配 问题 可 能 五 伦 八 
门 ， 这 里 束 需 要 有 合适 的 兼容 性 方案 去 尽 可 能 地 和 覆盖 测试 ， 在 实际 项 
目 中 也 确实 十 这 样 。 这 里 ， 和 读者 一 起 来 梳理 一 下 移动 平台 目 动 化 测 
试 到 撒 能 做 什么 ， 哪 些 场景 更 适合 用 目 动 化 测试 ， 这 些 目 动 化 测试 是 
人 盏 跨 越 了 我 们 传统 的 误区 。 图 2-6 所 示 为 笔者 梳理 的 Android 目 动 化 测试 
应 用 场景 ， 每 个 领域 里 内 容 不 是 非常 齐全 ， 目 的 是 引导 读者 一 起 去 思 
考 如 何 完 善 质量 保证 体系 的 自动 化 测试 场景 。 
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图 2-6 ” ”Android 自 动 化 测试 应 用 场景 


(1) 性 能 测试 。 移 动 终端 上 应用， 不管 是 Native 还 是 WebView 的 应 
用 ， 对 性 能 要 求 都 非常 高 ， 主 要 是 卡 顿 、 耗 电 、 速 度 这 几 个 常见 关键 
性 的 指标 ， 而 这 类 测试 重复 性 强 ， 指 标 路 径 固定 ， 并 且 质 量 指标 中 又 
需要 分 为 横向 与 纵向 对 比 情 景 ， 等 等 ， 形 成 一 个 庞大 的 测试 和 矩阵， 自 
动 化 测试 支持 才能 更 快捷 地 完成 测试 任务 ， 一 般 性 能 测试 会 考虑 选用 
自动 化 方案 ， 此 方案 非常 适合 性 能 测试 。 


(2) 稳定 性 测试 。Android 平 台 一 般 都 会 联想 到 用 系统 自 带 的 
Monkey 工 具 进行 测试 ， 此 工具 既 易 上 手 也 实用 ， 但 运用 起 来 有 非常 
的 讲究 和 技巧 ， 简 单 的 Monkey 工 具 不 一 定 能 完成 使 命 ， 在 测试 中 也 需 


要 花费 心思 去 对 原生 的 Monkey 进 行 改造 ， 以 满足 不 同业 务 的 稳定 性 测 


(3) 功能 测试 。 关 于 功能 测试 的 争议 比较 多 ， 因 为 产品 都 需要 快 
速 述 代 ， 而 脚本 的 稳定 性 、 实 现时 间 等 成 本 开销 大 ， 真 正 发 挥 作用 也 
需要 不 断 地 打磨 ， 并 且 还 有 很 多 后 期 维护 成 本 ， 所 以 比较 折 中 的 办 法 
苹 做 一 些 BVT 测 试 和 持续 集成 配合 ， 在 开发 编 详 新 的 build 后 直接 运行 
这 些 核心 的 BVT 用 例 ， 以 免 出 现 严 重 的 Regression/Block 问 题 ， 日 钊 的 
工作 中 选 定 较 小 范围 的 用 例 及 适合 的 框 染 一 般 束 可 以 解决 问题 。 


(4) 兼容 性 测试 。 不 同 的 业务 可 能 会 有 不 同 的 适 配 要 求 ， 现 在 比 
较 兽 用 的 方法 是 直接 使 用 业界 比较 成 熟 的 测试 平台 ， 如 Testin、 百 度 
MTC、 腾讯 优 测 平台 等 ， 一 般 情况 下 平台 能 提供 几 百 甚至 上 千 台 机 器 
进行 测试 。 本 书后 面 也 给 出 了 兼容 性 测试 方案 ， 供 各 读者 在 项 目 中 实 
I 


(5) 接口 测试 。 这 块 的 测试 主要 是 集中 一 些 重要 的 API 测 试 ， 和 
PC 端的 接口 测试 思路 一 样 ， 都 是 通过 脚本 去 遍历 所 有 重要 的 参数 等 ， 
并 且 抛 开 寞 面 的 干扰 快速 测试 以 至 稳定 。 像 浏览 郁 里 前 见 的 束 有 JS API 
接口 测试 ， 当 然 这 块 可 能 需要 开发 同学 的 接口 定义 文档 或 者 口头 文 
援 ， 梳 理 业 务 的 关键 API 和 参数 列表 以 及 相应 的 依赖 关系 等 ， 是 非常 适 
合用 目 动 化 测试 去 实现 的 ， 脚 本 也 相对 简单 稳定 ， 而 且 效 果 明 显 。 


(6) 单元 测试 。Android 终 端 用 Android Junit 可 以 快速 方便 地 实现 
单元 测试 。 很 多 公司 单元 测试 工作 都 是 由 开发 同学 自行 完成 ， 但 在 移 
动 互 联网 时 代 ， 基 于 敏捷 开发 测试 前 移 的 大 环境 ， 部 分 测试 同学 也 会 
直接 参与 单元 的 编写 和 执行 ， 比 如 ， 腾 讯 Tencent OS (TOS) 项 目 团队 
就 是 由 测试 同学 进行 单元 低层 OS 系统 的 单元 测试 ， 后 面 的 章节 也 会 讲 
到 这 块 的 测试 案例 。 


(7) 线 上 监控 测试 。 这 块 测试 方向 不 应 该 直接 归属 于 传统 的 自动 
化 测试 范畴 ， 因 为 它 不 需要 常规 情况 下 提 到 的 目 动 化 测试 框架 文 持 ， 
也 不 需要 开发 测试 用 例 脚 本 ， 这 里 主要 是 对 线 上 测试 数据 的 监控 ， 并 
且 利用 大 数据 分 析 进 行 “自动 化 测试， 在 互联 网 产品 中 极为 适用 而 且 
能 非常 直接 地 体现 产品 的 质量 。 举 个 和 商 单 的 例 于 ， 通 过 浏览 万 的 网 页 
浏览 功能 ， 可 以 监控 用 户 在 浏览 网 页 时 有 多 少 个 浏览 失败 的 网 站 、 是 
否 会 出 现 必然 浏览 失败 的 网 站 、 出 现 浏 览 失 败 的 网 站 的 地 域 /DNS 是 什 
么 等 ， 如 此 层 层 过 滤 ， 最 后 得 到 的 关键 信息 会 直接 指导 测试 人 员 缩 小 
测试 范围 ， 提 高 测试 效率 。 但 本 书 中 没有 准备 这 方面 的 案例 ， 笔 者 在 
梳理 这 块 内 容 时 ， 为 了 你 证 知识 的 完整 性 在 这 里 做 一 个 小 的 铺垫， 本 
书 再 版 时 会 添加 这 方面 的 案例 。 


2.3 本章 小 结 


其 实 目 动 化 测试 只 是 日 章 测 试 中 的 一 个 辅助 手段 ， 说 日 了 ， 写 驶 
是 利用 自动 化 测试 框架 以 及 工具 能 理解 的 程序 代替 人 去 完成 测试 ， 通 
过 比较 执行 的 结 末 来 判断 测试 是 否 通 过 。 它 的 优势 很 明显 ,无 论 多 复 
杂 的 操作 ， 即 使 反复 执行 成 干 上 万 裔 ， 只 要 程序 没有 问题 ， 它 都 会 
地 执行 完毕 ， 而 且 比 人 工 轻 松 得 多 ; 但 劣势 也 非常 明显 ， 最 大 的 缺 
扩 束 是 工具 是 人 工 思 考 之 后 的 一 个 固化 程序 ， 它 不 会 变通 ， 是 按照 人 
的 旨意 来 完成 相应 的 任务 。 所 以 测试 人 员 对 工具 的 应 用 和 改造 能 力 显 
得 尤为 重要 ， 通 过 对 被 测 应 用 的 深入 认识 与 思考 ， 转 化 成 可 以 实现 的 
测试 需求 ， 再 配合 这 些 工具 和 擅长 代码 的 同事 进行 封 狠 ， 可 以 完成 测 
试 中 各 个 领域 的 人 工 蔡 代 工 作 。 本 章 对 移动 终端 App 应 用 的 开发 、 测 
试 和 上 线 各 个 阶段 需要 的 测试 进行 目 动 化 测试 梳理 ， 分 析 目 动 化 测试 
的 应 用 场景 ， 为 后 面 的 框架 内 容 和 案例 提前 做 铺 楚 。 


< 
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第 3 革 ”Robotium 框 染 工 作 原 理 及 实践 


2010 年 ， 当 Android 还 处 于 发 展 早期 时 ， 拥 有 丰富 自动 化 测试 经 验 
的 Renas Reda 创 建 了 Robotium 项 目 ， 在 Robotium 发 展 到 4.0 版 本 时 开始 
支持 App 中 的 Web 自 动 化 ， 经 过 几 年 的 发 展 ，Robotium 现 在 已 经 是 一 款 
成 熟 、 全 面 、 稳 定 的 自动 化 测试 框架 。 更 重要 的 是 ，Robotium 是 一 款 
开源 的 测试 框架 ， 在 世界 各 地 都 有 活跃 的 贡献 者 对 其 进行 更 新 与 维 
护 ， 因 此 ， 无 须 担 心 将 来 Robotium 会 随 着 Android 的 发 展 而 变 得 不 可 
用 、 不 易 用 ， 相 反 ，Robotium 每 天 都 在 变 得 更 加 强大 。 


任何 技术 都 离 不 开 基 础 知识 。 首 先 ， 本 章 将 介绍 Robotium 有 是 什么 
以 及 有 天 Robotium 的 一 些 基础 知识 ， 让 读者 了 解 Robotium 的 基本 规 
则 。 其 次 ， 将 从 Native 和 WebView 两 方面 向 析 Robotium 测 试 框 以 的 运作 
原理 ， 并 介绍 Robotium 的 实际 应 用 以 及 笔者 在 实践 过 程 的 一 些 经 验 技 
巧 ， 以 加 深 读 者 对 Robotium 测 试 框架 的 理解 。 最 后 ， 本 革 选 取 一 般 项 
目 中 种 见 的 一 些 场景 介绍 如 何 使 用 Robotium 解 决 实践 中 的 问题 。 


本 章 知识 结构 图 如 图 3-1 所 示 。 


阅读 完 本 章 后 ， 读 者 应 该 能 比较 全 面 地 了 解 Robotium 测 试 框架 并 
知道 如 何 使 用 了 ， 由 于 本 章 只 介绍 Robotium 相 关 知 识 ， 关 于 Robotium 
在 项 目 方面 的 实际 应 用 则 可 阅读 第 10 章 。 
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图 3-1 ”本章 知识 结构 图 


3.1 Robotium 和 常用 功能 


3.1.1 什么 是 Robotium 


Robotium 是 一 款 类 似 Selenium 但 面向 Android 端 的 开源 上 自动 化 测试 
框架 ， 既 支持 测试 Native 应 用 ， 也 支持 测试 Hybrid 应 用 〈 混 合 模式 应 
用 ， 指 介 于 WebApp 福 NativeApp 两 者 之 间 的 App， 兼 有 具 Native App 民 好 
的 用 户 交 互 体验 的 优势 以 及 Web App 跨 平台 、 易 变更 的 优势 ) ; 既 支 
持 黑 盒 形 式 的 自动 化 测试 ， 也 支持 白 盒 形式 的 自动 化 测试 。 通 过 
Robotium 用 户 可 以 编写 出 更 强大 健壮 的 UI 自动 化 测试 用 例 ， 并 可 以 应 
用 在 功能 测试 、 系 统 测 试 、 用 户 验 收 测试 等 多 种 测试 场景 
Robotium 主 要 具有 以 下 优势 : 


.同时 文 持 Native 应 用 和 Hybrid 应 用 。 


.由 于 是 基于 Instrumentation 的 测试 ， 测 试 代码 运行 于 被 测 应 用 所 
在 的 进程 ， 控 件 识 别 与 模拟 UI 事件 都 可 以 快速 执行 ， 因 此 测试 用 例 执 
行 速度 更 快 。 


由 于 是 通过 在 运行 时 识别 控件 而 非 通过 固定 坐标 方式 ， 因 此 测试 
用 例 可 以 更 健壮 。 


.由 于 支持 黑 盒 方式 ， 不 需要 深入 了 解 被 测 应 用 即 可 开展 测试 ， 因 
此 编写 用 例 花费 的 时 间 可 以 更 少 。 


.由 于 可 以 通过 Maven、Gradle 或 者 Ant 运 行 测试 用 例 ， 因 此 可 以 很 
好 地 作为 持续 集成 的 一 部 分 。 


Robotium 缺 点 : 
.由 于 是 基于 Instrumentation 的 事件 发 送 ， 因 此 无 法 跨 应 用 。 


代码 运行 在 被 测 进程 ， 可 能 影响 被 测 进程 的 内 存 、CPU 占 用 ， 寿 
用 于 性 能 监控 数据 会 有 误差 。 


注 : 项 目 开 源 地 址 : https://github.com/RobotiumTech/robotium 


3.1.2 Robotium 提 供 的 类 


Robotium 对 外 主要 提供 以 下 几 个 类 : 
By: Web 元素 的 选择 癸 。 
-Condition: 接口 类 ， 用 于 等 待 。 
.RobotiumUtils: 工具 类 。 

Solo: 对 外 提供 各 种 API 。 
.Solo.Config: Solo 配 置 类 。 
.SystemUtils: 系统 级 工具 类 。 
.TimeOut: Solo 配 置 类 。 


`WebElement: Web 元 素 的 抽象 类 。 


其 中 Solo 类 是 主要 对 外 提供 各 种 API 的 类 ，Solo 类 采用 中 介 者 模 
式 ， 持 有 com.robotium.solo 包 下 的 其 他 类 的 实例 对 象 ， 当 我 们 调用 Solo 
类 中 的 API 时 ， 大 多 数 是 转 而 调用 com.robotium.solo 包 下 其 他 类 的 方 
法 。com.robotium.solo 包 下 主要 有 以 下 类 : 


'Getter: 提供 控件 获取 相关 API。 
'ActivityUtils: 提供 Activity 相 关 API 。 
.Asserter: 提供 断言 相关 的 API。 
Clicker: 提供 模拟 点 击 相 关 的 API。 
.ScreenshotTaker: 提供 截图 相关 的 API。 
'Scroller: 提供 滚动 相关 的 API。 
'Searcher: 提供 控件 搜索 相关 的 API 。 
ViewFetcher: 提供 控件 过 滤 相 关 的 API。 
"Waiter 提供 控件 等 每 相关 的 API。 
-WebUtils: 提供 Web 文 持 相 关 的 API。 


Robotium 为 了 简化 测试 用 例 的 编写 ， 将 以 上 的 这 些 类 都 置 为 
protected， 对 外 只 提供 Solo 类 ， 因 此 ， 在 编写 测试 用 例 时 ， 主 要 实例 
化 Solo 类 即 可 ， 本 章 介 绍 的 API 默 认 也 均 为 Solo 类 中 的 方法 。 


3.1.3 “环境 搭建 


使 用 Robotium 进 行 自动 化 测试 的 工程 采用 的 是 Android Junit Test 工 
程 ， 基 础 环境 与 Android 开 发 环境 一 致 ， 为 了 方便 本 书 第 3 章 及 第 10 章 的 
讲解 ， 本 书 的 官网 (http://tmq.qq.com/ ) 附 上 了 改造 后 的 NotePad 和 
NotePadTest 工 程 ， 环 境 搭建 步骤 如 下 : 


步骤 1: 安装 基础 环境 (搜索 引擎 搜 *Android 开 发 环境 搭建 ”) 
步 又 2: 导入 工程 。 


下 载 随 书 官网 中 的 NotePad 和 NotePadTest 两 个 工程 ， 打 开 
Eclipse~ File Import， 选 择 “Existing Projects into Workspace”， 如 图 3-2 
所 示 。 远 择 NotePad 工 程 所 在 的 目录 ， 守 入 NotePad 工 程 。 使 用 相同 的 
步 又， 导入 NotePadTest 工 程 。 如 图 3-3 所 示 。 


图 3-2 ”选择 导入 已 存在 的 工程 至 工作 空间 
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图 3-3 ”选择 NotePad 及 NotePadTest 工 程 所 在 的 目录 
步骤 3: 配置 工程 。 


导入 两 个 Demo 工 程 后 ， 由 于 两 个 工程 均 包 含有 一 些 配 置 文件 ， 
此 如 果 没 有 提示 错误 ， 则 可 以 直接 使 用 ， 如 果 还 有 提示 错误 ， 请 依 实 


际 情况 检查 以 下 配置 项 。 


(1) 配置 签名 : 两 个 工程 需要 签名 一 致 ， 这 里 使 用 Android 开 发 环 
境 中 自 带 的 debug.keystore 进 行 签名 ， 因 此 需要 确保 环境 中 包含 该 签名 
文件 ， 签 名 配置 查看 : Window 一 Preferences Android 一 Build， 如 图 3- 
AA 


(2) 配置 build target: build target 即 指定 使 用 哪个 Android 平 台 来 
构建 这 个 项 目 ， 两 个 工程 均 配置 为 使 用 target=android-19， 即 使 用 sdk 中 
platforms 目 录 下 android-19 目 隶 中 的 android.jar 这 个 jar 包 编译 项 目 ， 如 图 
3-5 所 示 。 


若 你 的 开发 环境 中 未 下 载 相 应 的 API level 的 jar 包 ， 请 使 用 SDK 
Manager 下 载 ， 或 者 自行 将 project.properties 配 置 文件 中 的 target 换 成 用 户 
机 姻 中 已 下 载 的 APIlevel 。 
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type filter text Build 一 和 
General Build Settings: 
4 Android 


可 Automatically refresh Resources and Assets folder on build 


Build 
v j i ive libraries 
DDN IV| Force error when external jars contain native librarie 
Editors 如 Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output 
Lint Error Checking © Silent 
LogCat ”) Normal 
NDK Verbose 
Usage Stats i 
Ant Default debug keystore: Ci\Users\Administrator\.android\debug.keystore 


C/C++ MDS fingerprint: 31:CB:CD:9B:67:32:6A:F8:FD:39:FB:E1:13:D2:E9:59 
Code Recommenders 
SHA1 fingerprint: BA:06:5D:48:25:DC:9F:25:17:B4:07:0F:A7:3D:D5:43:4D:98:69:01 


Ecaen Fn 


1# This file is automatically 
2# Do not modify this file -- 

by 名 gen [Generated java Files] 子音 
4# This file must be checked i 


4 人 2 NotePadTest 
> 种 src 
| 


4 BR Android 4.4.2 


b es androidjar - E:\Android\sdk\platforms\android-19 


2 Android Private Libraries 
by Es bin 

b Eb libs 

Eb res 

EC sources 
AndroidManifestxml 


lintxml 


a 


目 project.properties 


5# 

6# To customize properties use 
7# "ant.properties", and overr 
8# project structure. 

9 

18# Indicates whether an apk sh 
11 split.density=false 

12# Project target. 
13target=android-19 

14 


图 3-5 配置 build target 


(3) 引用 Robotium 的 jar 包 并 关联 源码 : Robotium 测 试 框架 以 jar 包 
形式 提供 ， 在 测试 工程 中 引用 Robotium 的 jar 包 即 可 。Android 的 Junit 形 
式 测试 工程 与 Android 工 程 一 样 ， 将 要 引用 的 jar 包 放 入 libs 目 录 下 ， 在 
Eclipse 中 将 默认 变 成 Android Private Libraries 私 有 库 ， 这 样 默认 在 
Eclipse 中 残 可 以 引用 该 jar 中 的 API， 在 编译 时 也 会 将 其 编译 进 测试 工程 
的 APK 中 ， 如 图 3-6 所 示 。 
此 外 ， 为 了 方便 查看 Robotium 中 的 源码 实现 ， 一 般 也 会 选择 天 联 


引用 的 jar 包 的 源码 ， 如 上 图 所 示 ， 在 libs 中 新 建 相应 的 properties 文 件 ， 
然后 使 用 src= 形 式 的 命令 指定 源码 所 在 的 目录 即 可 。 


4 5 NotepadTest ^ 1src = ..\\sources\\robotium-master.zip 
> 种 src 

bp gen [Generated java Files] 

”下 Android 4.4.2 


| 副 Android Private Libraries 


by Bs uiautomator-v18-2.1.0jar - E:\WorkSpace\NotePadTest\libs 
》 Bb robotium-solo-5.5.4jar - E:\WorkSpace\NotePpadTest\libs 
by ES bin 


4 bb, libs 


邮 | robotium-solo-5.5.4jar 

国 robotium-solo-5.5.4jar.properties 
内 | Ulautomator-v18-2.1.0Jar 

目 uiautomator-v18-2.1.0jarproperties 


b Es res 


一 -一 


4 [> sources 
国 robotium-masterzip 
二 | uiautomator-v18-2.1.0-sourcesJjar 
四 AndroidManifestxml 


图 3-6 ”配置 Robotium 的 jar 包 并 关联 源码 


(4) 配置 编码 : 新 导入 工程 后 ， 由 于 工程 里 会 含有 一 些 中 文 注 
释 ， 和 常常 会 由 于 编码 不 一 怪 ， 导 人 致 代码 结构 被 破 坏 而 引起 工程 编译 出 
错 ，Demo 中 的 两 个 工程 均 采 用 UTF-8 编 码 ， 因 此 需要 检查 导入 后 编码 
是 否 为 UTF-8， 右 键 工 程 依 次 选择 Properties 一 Resource， 查 看 编码 ， 如 
图 3-7 所 示 。 


合 Properties for NotePadTest [ol 
|type filter text | Resource Cj 
加 Resouree Path: /NotePadTest 
Unked Resources 
Type: Project 
Resource Filters , 
cd Location: E:\WorkSpace\NotePadTest 
Android Lint Preferences | Last modified: 2016 年 4 月 17 日 下 午 2:31:23 
Buiiders —Text fleencoding 
C Generation and Revers © Inherited from container (UTF-8) 
Java Build Path 站 Other UTF-8 
;Java Code Sty| 一 
9 a * 四 | Store the encoding of derived resources separately 


图 3-7 配置 编码 


(5) 配置 Instrumentation: 测试 工程 需要 配置 Instrumentation 以 指 
定 要 注入 的 被 测 进程 ， 即 指定 被 测 App， 在 NotePadTest 中 使 用 
<instrumentation> 标 签 指 定 targetPackage 为 被 测 应 用 的 包 名 ， 如 图 3-8 所 


首先 确保 有 手机 开局 了 USB 调 试 ， 并 连接 了 电脑 ， 然 后 如 图 3-9 所 
示 ， 右 键 选 择 示 例 的 测试 类 ， 例 如 右键 选择 NotePadTest.java 类 ， 选 择 
Run As 一 Android Junit Test， 即 可 运行 Demo 中 的 测试 用 例 。 


4 中 Notcpad 医 1 <?xml version="1.0" encoding="utf-8"?> 
v 可 Android 4.4.2 2= <manifest xmlns:android="http;//schemas.android.com/opk/res/android" 
3 package="com. robotium. test™ 
i comroboiin nandroid.notepad 4 android:versionCode="1" 
b 所 genT 人 Fled] 5 androi version ne he by, M2 
EB assets 6 applic :icon= es con™ 
pS bm 7 andr tt est ]- 二 "ing/app_name™" 
bi res 3 
BD ndrolMantest ml 9 《uses-library android:name="android.test.runner" /> 
En 19 /application> 
F 11 <uses-sdk android:minSdkVersion="19" /> 


BB project.properties 


2 <instrumentation 
4 站 NotepadTest 琶 4 3 ] 


下 13 android:E dE "com, robotium. android.notepad" 
dh 14 android:name= "android. test.InstrumentationTestRunmer" /> 
| DP Bcom.robotiumtest 15 <instrumentation 
D 由 com.robotiumtest.constant 16 android:targetPackage="com. robotiym.android.anothernotepad" 
bp 册 com.robotiumtest.hol 17 android:name=",. instrumentation. InstrumentationTestRunnern" /> 
b comrobotium.test.instrumentation 18 </manifest> 


”用 comrobotiumtest.uiautomator 
D robotium.test,util 
b 四 gen [Gcncratcd Java Files} 
;BR And 4.42 
六 本 Android Privete Lbrarics 
》 ES bin 
EB libs 
b ES res 
”请 sources 
5 AndroidManifest.xml 


图 3-8 ”配置 Instrumentation 


4 ‘> NotepadTest 
4 5 由 src 
4 出 com.robotium,test 
中 NotepadTestjava | 
IN NotepPadTestWithSpoonJjava 
》 上 NotepadTestWithUIAutomatorjava 


图 3-9 ”运行 示例 


对 于 环境 搭建 ， 痢 手 较 容易 出 现 如 下 问题 : 


见 问 题 1: The import android cannot be resolved 


需要 检查 上 文 配 置 工程 部 分 中 配置 的 build target 是 否 正 确 。 


见 问题 2，java.lang.NoClassDefFoundError: 


com.robotium.solo.Solo 


NoClassDefFoundError 指 在 编译 时 该 类 是 存在 的 ， 但 在 运行 的 时 候 
找 不 到 该 类 ， 报 找 不 到 Solo 类 时 一 般 意味 着 Robotium 的 jar 包 未 打 进 测 
试 工 程 的 apk 包 中 。 首 先 ， 右 键 测 试 工程 ~ Build Path ~ Configure Build 
Path， 得 看 确保 在 Libraries 中 包含 了 Robotium， 如 网 3-10 所 示 。 由 于 
demo 中 将 Robotium 的 jar 包 放 至 libs 目 录 下 了 ， 因 此 默认 将 包含 至 
Android Private Libraries 中 。 


将 被 打包 进 


在 运行 


然后 ， 如 图 3-11 所 示 ， 在 Build Path 的 Order and Export 中 确保 


Robotium 的 jar 包 处 于 勾 选 状态 〈 处 于 勾 选 状态 即 
测试 工程 的 APK 中 ， 而 例如 Android SDK 中 的 android.jar 
包 ， 由 于 其 Class 类 在 手机 的 Android 系 统 中 已 存在 ， 因 此 不 需要 勾 选 
去 行 时 也 可 以 找到 相应 的 类 ) 。 


合 Properties for NotePadTest 


ltype filter text 


» Resource 
Android 
Android Lint Preferences 
Builders 
C Generation and Rever: 
Java Build Path 

» Java Code Style 

”Java Compiler 

by Java Editor 
Javadoc Location 

» Papyrus 
Project References 
Refartnrinn Hi<tmrv 


Java Build Path 


[意味 着 该 jar 的 Class 类 


(由 Source | 局 projects| BN Libraries | Order and Export 


JARs and class folders on the build path: 


而 Android 4.4.2 
by BB Android Dependencies 
4 BM Android Private Libraries 
吕 Access rules: No rules defined 
BB: Native library location: (None) 
b [ee uiautomator-v18-2.1.0jar - E\WorkSpace\Note 


名 robotium-solo-5.5.4jar - 


[oo Ee | 
bs -ww 
Add JARs... 


Add External JARs... 


Add Variable... 


Add Library... 


\WorkSpace\NoteP; 


Add Class Folder... 中 


Add External Class Folder..| 


图 3-10 ”确保 Libraries 中 包含 Robotium 


合 Properties for NotepadTest 


|type filter text 


b Resource 
Android 
Android Lint Preferences 
Builders 
C Generation and Rever: 
Java Build Path 

》 Java Code Style 

》 Java Compiler 

》 Java Editor 
Javadoc Location 

b Papyrus 


SEE 
Java Build Path mv cv 十 
Build class path order and exported entries: 
(Exported entries are contributed to dependent projects) 
辑 起 NotepadTest/src Up 
辑 路 NotepadTest/gen 一 
Down 
到 \Android 4.4.2 
巴 Notepad 
Android Private Libraries Ia 
Android Dependencies rp 


图 3-11 确保 Order and Export 中 Robotium 的 jar 包 被 勺 选 


3.1.4 ”Robotium 的 控件 获取 、 操 作 及 断言 


Robotium 是 一 于 在 Android 客 户 端 中 的 自动 化 测试 框架 ， 它 需要 模 
拟 用 户 操作 手机 屏幕 。 要 完成 对 手机 的 模拟 操作 ， 应 该 包含 以 下 几 个 
基本 操作 : 


(1) 需要 知道 所 要 操作 控件 的 坐标 。 


(2) 对 要 操作 的 控件 进行 模拟 操作 。 


(3) 判断 操作 完成 后 的 结果 是 否 符合 预期 。 


因此 ， 本 和 将 从 控件 获取 、 控 件 操 作 及 操作 后 断言 来 介绍 
Robotium， 此 外 ， 由 于 WebView 在 控件 获取 和 控件 操作 上 都 与 Native 完 
全 不 同 ， 将 对 其 做 单独 介绍 。 


1.Native 控 件 获 取 


从 Robotium 中 获取 Native 控 件 主要 有 两 大 方式 : 一 个 十 根据 被 测 应 
用 的 控件 ID 来 获取 ;， 男 一 个 是 先 获 取 当 前 界面 所 有 的 控件 ， 对 这 些 控 
件 进 行 过 滤 封 又 后 再 提供 相应 的 获取 控件 的 API。 


1) 根据 被 测 应 用 的 控件 ID 来 获取 


根据 控件 ID 获取 见 表 3-1。 


表 3-1 根据 控件 ID 获取 


返回 值 方法 及 说 明 
View getView(1nt 0) 
根据 ID 获取 控件 
View getView(String ID) 


根据 ID 获取 控件 


根据 String 型 ID 获 取 控 件 : 


ImageView mIcon = (ImageView) solo.getView("mypic"); 


在 Android 中 ， 所 有 的 控件 都 继承 自 View， 因 此 ， 如 果 被 测 应 用 中 
的 控件 有 了 唯一 ID 的 话 ， 束 可 以 使 用 这 种 通过 ID 形 式 唯一 获取 所 要 操作 
2 


例如 获取 RelativeLayout 或 LinearLayout: 


RelativeLayout rel = (RelativeLayout) solo.getView("example1"); 
LinearLayout lin = (LinearLayout) solo.getView("example2"); 


由 于 Android 中 所 有 的 控件 都 继承 自 View 类 ， 而 对 于 开发 人 员 的 目 
定义 控件 ， 这 些 目 定义 控件 也 基本 是 继承 目 Android 的 基础 控件 扩展 而 
来 的 ， 因 此 通过 这 种 方式 几乎 可 以 获得 所 有 类 型 的 控件 ， 获 取 相 应 类 


型 的 控件 时 只 要 进行 转 义 即 可 ， 因 此 当 控 件 拥有 唯一 ID 时 ， 推 荐 使 用 
该 方式 。 


控件 ID 可 以 通过 Android SDK 中 提供 的 工具 来 查看 ， 例 
如 %ANDROID_HOME%\tools\uiautomatorviewer.bat 工 具 ， 在 Android 
4.3 及 以 上 系统 版 本 的 手机 上 ， 可 直接 得 看 到 UI 界 面 的 ID 。 


2) 根据 控件 类 型 的 索引 、 文 本 来 获取 


根据 文本 获取 见 表 3-2。 


表 3-2 根据 文本 获取 


返回 值 方法 及 说 明 
i getButton(int Index) 
utton , We 
根据 index 索引 获取 控件 
getButton(String text) 
Button 


根据 文本 text 获取 控件 


此 方式 是 Robotium 先 将 当前 界面 中 的 所 有 控件 全 部 获取 ， 人 然后 按 
控件 类 型 、 索 引进 行 过滤 后 再 获取 指定 的 控件 View。 


根据 index 索 引 获 取 探 件 : 


/ /返回 界面 中 第 一 个 类 型 为 


Button 的 控件 


Button loginBtn = (Button) solo.getButton(0); 


其 他 的 如 getEditText (int index) 、getText (int index) 均 同 理 。 


根据 文本 text 获 取 控 件 : 


/ /返回 界面 中 文本 为 ‘登录 ' 类 型 为 


Button 的 控件 


Button loginBtn = (Button) solo.getButton(" 登 录 


"); 


其 他 的 如 getText (String text) 、getEditText (String text) 均 同 
理 。 


@@ 提示 在 Robotium 中 查找 控件 时 ， 如 果 找 不 到 相应 1D 或 文本 
的 控件 ， 测 试 框架 会 throw 出 “View with idxxxis no found” 或 者 “with 
textxxxno found” 等 Throwable 寞 常 ， 寿 我 们 并 不 希望 因此 而 报销 ， 则 可 
以 使 用 try catch Throwable 来 捕获 。 


3) 根据 控件 类 型 进行 过 滤 
根据 类 型 过 滤 见 表 3-3。 


表 3-3 ”根据 类 型 过 小 


返回 值 方法 及 说 明 
getCurrentViews() 

获取 当前 界面 或 弹 框 中 所 有 的 控件 

getCurrentViews(Class<T> classTIoFlilterBy) 

获取 当前 界面 或 弹 杠 中 所 有 控件 类 型 为 classToFilterBy 的 控件 


ArrayList<View> 


ArrayList<T> 


getCurrentViews(Class<T> classToF!ilterBy, View parent) 


ArrayList<T> a i . 网 本 让 
获取 父 控 件 parent 下 所 有 控件 类 型 为 classToFilterBy 的 控件 


获取 当前 界面 或 弹 框 中 所 有 控件 类 型 为 TextView 的 控件 : 


ArrayList<TextView> allTextViews = solo 
.getCurrentViews(TextView.class); 


获取 指定 父 控件 下 所 有 控件 类 型 为 TextView 的 控件 : 


RelativeLayout rel = (RelativeLayout) solo.getView("example1"); 
ArrayList<TextView> allTextViews = solo 
.getCurrentViews(TextView.class, rel); 


同样 是 过 滤 出 指定 的 控件 类 型 ， 不 过 该 方法 是 从 父 视 图 parent 中 开 
始 过 滤 ， 当 不 指定 parent， 即 solo.getCurrentViews 〈TextView.class， 
null) 时 ， 则 和 solo.getCurrentViews (TextView.class) 一 样 ， 返 回 的 是 
当前 界面 中 所 有 的 。 


移动 App 一 般 节 奏 很 快 ，UI 布 局 结构 也 经 常 随 着 功能 的 变更 而 变 
动 ， 例 如 “登录 ”按钮 从 最 上 面 变 到 了 最 下 面 ， 因 此 通过 索引 或 文本 来 
获取 控件 是 有 很 大 隐患 的 。 很 多 时 候 ， 通 过 巧妙 地 控件 过 滤 可 以 更 准 
确 地 找到 相应 的 控件 。 


2.Native 控 件 操作 


对 于 Android 闹 的 目 动 化 测试 而 言 ， 当 我 们 获取 到 期 望 的 控件 后 ， 
授 下 来 整 是 对 该 控件 进行 扣 击 、 长 按 、 文 本 输入 、 抑 动 等 模拟 操作 。 
除 此 之 外 ，UI 目 动 化 测试 为 了 贴近 用 户 的 真实 使 用 及 上 自身 健壮 性 ， 还 
需要 时 延 等 待 、 页 面 加 载 等 待 ， 为 了 判断 界面 是 否 符合 预期 ， 则 还 需 
要 控件 搜索 、 界 面 截图 等 操作 。 


1) 点 击 、 长 按 操 作 


反击 长 按 见 表 3-4。 


表 3-4 ”点 击 长 按 


返回 值 方法 及 说 明 
k clickOnView (View view) /clickLongOnView (View view) 
void ee 
点 击 指定 的 View 控件 /长 按 指定 的 View 控件 
jd clickOnScreen (float x., float y) /clickLongOnScreen (float x, Hoat y) 
Void 


根据 坐标 x,y 点 击 屏幕 /根据 坐标 x, y 长 按 屏 幕 


Robotium 是 基于 控件 的 自动 化 测试 框架 ， 当 获取 到 要 操作 的 控件 
， 直 接 对 控件 进行 点 击 、 长 按 或 文本 输入 等 操作 即 可 。 


Hh 


扩 击 指定 的 View 控 件 : 


Button loginBtn = (Button) solo.getView("loginBtn"); 
solo.clickOnView(loginBtn) 


Robotium 还 提供 了 点 击 文本 、 点 击 图 片 的 API， 例 如 clickOnText 
(String text) 、click-OnButton (String text) 等 ， 这 类 API 类 似 于 前 文 


所 介绍 的 ， 先 根据 文本 获取 控件 ， 再 发 送 点 击 事件 : 


Button loginBtn = (Button) solo.getButton(" 登 录 


"); 
solo.clickOnView(loginBtn) 


类 似 于 点 击 、 长 按 指定 的 View 探 件 : 


Button loginBtn = (Button) solo.getButton(" 登 录 


/ 
solo.clickLongOnView(loginBtn) 


需要 注意 的 是 ，Robotium 的 点 击 事件 是 通过 Instrumentation 发 送 
的 ， 因 此 该 类 点 击 方法 不 能 点 击 非 被 测 应 用 的 区 域 ， 例 如 不 能 点 击 至 
通知 栏 所 在 的 区 域 ， 否 则 会 出 现 类 似 如 下 的 异常 : 


java.lang.SecurityException: "Injecting to another application requires 
INJECT_EVENTS permission" 


因此 在 使 用 Robotium 编 写 测试 用 例 时 ， 需 要 注意 其 无 法 跨 应 用 的 
缺点 ， 从 而 尽量 避免 出 现 此 场景 ， 有 些 场景 偶然 性 地 无 法 规避 ， 可 以 
采用 try catch Throwable 的 形式 捕获 异常 ， 而 对 于 需要 跨 应 用 的 场景 ， 
则 可 以 使 用 9.4.2 节 介绍 的 UI Automator 结 合 Instrumentation 模 式 进行 处 
理 。 


try { 
} catch (Throwable e) { 


名 技 石 ”在 手机 设置 -开发 者 选项 中 ， 可 以 开启 < 指针 位 置 *， 开 
启 < 指针 位 置 " 后 ， 再 触摸 屏幕 时 ， 可 实时 显示 屏幕 坐标 。 调 试 时 为 了 
更 准确 地 知道 对 屏幕 的 什么 地 方 进行 了 操作 ， 也 常常 同时 开启 < 显示 甬 
摸 操作 "开关 。 


2) 操作 输入 框 


操作 输入 框 见 表 3-5。 


表 3-5 ”操作 输入 框 


返回 值 方法 及 说 明 


enterText(EditText editText, String text) 


Vold sa ， ER 
在 指定 的 EditText 中 输入 文本 text 
typeText(EditText editText, String text) 
Vold pr jonrer mic 
在 指定 的 EditText 中 键入 文本 text 
， clearEditText(EditText editText) 
void 


清空 指定 的 输入 框 


在 目 动 化 测试 过 程 中 ， 当 我 们 可 以 准确 获取 控件 ， 并 能 模拟 点 
击 、 长 按 等 基本 操作 后 ， 束 可 以 在 被 测 应 用 中 进行 目 由 跳 转 ， 然 后 可 
能 就 需要 进行 一 些 输入 操作 。 测 试 框架 中 主要 提供 了 enterText 
(EditText editText, String text) 和 typeText (EditText editText, String 
text) 两 种 方法 ， 前 者 直接 对 EditText 文 本 框 进行 赋值 ， 不 会 有 文本 输 
入 的 展示 过 程 ， 而 后 者 则 会 一 个 文本 一 个 文本 地 输入 ， 更 贴近 真实 用 
户 的 操作 。 


EditText userET = (EditText) solo.getView("example et_ id"); 
solo.enterText(userET, "my_user_name") / /直接 对 文本 框 赋值 


solo.typeText(userET, "my_user_name") / /会 展示 输入 的 过 程 


3) 消 动 、 滚 动 


滑动 、 滚 动 见 表 3-6 。 


表 3-6 请 动 、 深 动 


返回 值 方法 及 说 明 
drag(float fromX. float toX. Hoat fromY., Hoat toY., int stepCount) 
void 5 A 
从 起 始 x,y 坐标 滑 至 终点 x,y 坐标 ; 通过 stepCount 参数 指定 滑动 时 的 步 长 


scrollToTop() / scrollToBottom() 


void eC A 
滚动 至 顶部 / 滚动 至 底部 
scrollUp() / scrollDown() 
void ; dt 
回 上 滚动 屏幕 / 回 下 滚动 屏幕 
二 scrollListToLine(AbsListView absListView. int line) 
VOid 


滚动 列表 至 第 line 行 


在 Android 中 ， 党 用 的 操作 还 有 各 种 滑动 手势 ， 如 上 拉 、 下 拉 、 左 
消 、 右 滑 等 。 在 滑动 方面 ， 测 试 框 染 主要 提供 了 两 类 支持 ， 一 类 是 根 
据 坐 标 进行 渭 动 从 而 可 以 模拟 各 类 手势 操作 ， 男 一 类 则 是 根据 控件 来 
直接 进行 滚动 操作 。 


根据 坐标 进行 滑动 的 主要 是 drag (float fromX，float toX，float 
fromY，float toY，int step Count) ， 这 里 的 参数 包括 起 始 位 置 的 x 与 y 坐 
标 、 终 点 位 置 的 x 与 y 坐 标 ， 还 有 步 长 stepCount。 其 中 步 长 stepCount 的 
意思 是 ， 假 如 要 从 A 点 请 到 B 点 ， 如 果 步 长 为 1， 那 么 将 直接 产生 从 A 点 
到 B 点 的 手势 操作 ， 滑 动 速度 很 快 ， 如 果 步 长 为 100， 则 将 从 A 到 B 分 成 


100 等 份 ， 例 如 A、A1、A2...B， 然 后 依次 从 A 滑 到 A1， 再 从 Al 请 到 
A2、A2 滑 到 A3...... 这 样 滑 动 更 慢 但 结果 也 更 精确 ， 例 如 当 我 们 在 手机 
上 快速 从 下 往 上 滑动 时 ， 列 表 滑动 是 有 惯性 的 ， 会 快速 深 动 ， 而 这 常 
常 不 是 我 们 所 需要 的 。 


根据 控件 进行 滚动 主要 有 滚动 至 顶部 、 底 部 等 方法 。scrollToTop 

() 方法 可 以 将 当前 屏幕 滑 至 顶部 ， 如 果 当 前 是 ListView 则 滑 至 列表 的 
顶部 ， 如 果 是 webView 则 滑 至 页 面 的 顶部 。 同 样 地 ，scrollToBottom 

() 可 将 界面 滑 至 底部 。 类 似 的 还 有 向 下 滑 一 屏 的 scrolDown () 方法 
和 向 上 清 一 屏 的 scrolUp () 方法 。 与 前 文 介绍 的 drag 方 法 不 同 的 是 ， 
这 类 滚动 调用 的 是 相应 控件 自身 的 API， 例 如 WebView 的 滚动 调用 的 是 
控件 自身 的 pageUp (boolean top) 或 pageDown (boolean bottom) 方 
法 。 因 此 ， 这 种 方式 与 drag 方 式 最 大 的 区 别 在 于 ，drag 是 实际 地 模拟 手 
劳 操 作 ， 当 上 拉 时 ， 如 采 ListView 有 监听 上 拉 加 载 更 多 ， 那 么 使 用 drag 
是 可 以 触发 上 拉 加 载 更 多 的 ， 而 scrollUp () 则 不 能 。 


4) 搜索 与 等 待 


搜索 与 等 待 见 表 3-7。 


表 3-7 搜索 与 等 待 


返回 值 方法 及 说 明 


sleep(int time) 


void DR 
休眠 指定 的 时 间 ， 单位 毫秒 
i searchText(String text) 
oolean es Sa 
从 当前 界面 搜索 指定 文本 
wailtForView(int 1d) / wW WE orText(String text) 
boolean NR 
竺 待 指定 控件 出 现 / 等 待 指定 文本 出 现 
wailtForActivity(String name) 
boolean pr bat 
于 待 指 定 的 Activity 出 现 
waitForLogMessage(String logMessage) 
boolean NE 
于 何 指 自 的 | | 了 人 且 . 出 现 
waitForDialogToOpen() / waitForDialogToClose() 
boolean 


等 待 弹 框 打开 / 等 待 弹 框 关闭 


UI 目 动 化 测试 肖 第 被 诈 病 运行 不 稳定 ， 除 了 项 目 快速 大 代 导致 界 
面 经 肖 变 更 这 一 不 可 探 因素 外 ， 脚 本 第 第 运行 出 错 就 古 由 于 没有 合适 
的 等 每 机 制导 致 控件 未 找到 、 点 击 异常 等 问题 ， 要 想 测 试用 例 能 够 快 

且 稳 定 地 运行 ， 合 理 使 用 等 竺 是 关键 要 素 之 一 。 


Robotium 中 提供 了 诸多 与 等 待 相关 的 API， 但 是 实际 情况 中 需要 等 
每 的 操作 往往 要 复杂 得 多 ， 因 此 测试 框架 中 也 提供 了 Condition 模 式 ,， 
即 waitForCondition (Condition condition，int timeout) 方法 ， 使 用 该 方 
法 时 ， 实 现 Condition 接 口 并 重 写 isSatisfied () 方法 ，isSatisfied () 为 
true 时 将 跳出 等 待 。 通 过 这 种 模式 我 们 可 以 自 定 义 实现 更 多 类 型 的 等 待 
操作 ， 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 ”使 用 waitForCondition 模 式 实现 等 待 


public void waitForAppInstalled(final String appName, int timeout) { 
waitForCondition(new Condition() { 
@Override 
public boolean isSatisfied() { 
sleeper.sleepMini(); 


return checker.isAppInstalled(appName); 


}, timeout); 


} 
当然 了 ， 我 们 也 可 以 使 用 超时 机 制 来 实现 ， 如 代码 清单 3-2 所 示 。 
代码 清单 3-2 ”使 用 TimeOut 模 式 实现 等 待 


public void waitForAppInstalled(final String appName, int timeout) { 
long endTime = SystemClock.uptimeMillis() + timeout 
while (SystemClock.uptimeMillis() < endTime) { 
if (checker.isAppInstalled(appName)) { 
break; 
sleeper.sleep(); 


} 
} 


需要 注意 的 是 ，Robotium 中 得 找 控件 、 点 击 控件 等 API 都 默认 使 用 
了 搜索 与 等 竺 机 制 ， 当 我 们 使 用 上 文 捉 到 的 获取 控件 、 点 击 控件 相关 
操作 时 ， 测 试 框架 已 经 做 好 了 等 竺 操作 ， 因 此 非特 殊 情 况 是 不 需要 额 
外 增加 等 待 操作 的 步骤 的 。 太 多 的 等 待 将 使 用 例 执 行 变 得 缓慢 低 效 ， 
因此 在 用 例 编写 调试 过 程 中 应 该 做 好 平衡 。 


5) 截图 及 其 他 
截图 及 其 他 见 表 3-8 所 示 。 


表 3-8 ”截图 及 其 他 


返回 值 方法 及 说 明 


takeScreenshot(String name) 


void gr SR Se pd ne ’ 
截图 ,图 片 名 称 为 指定 的 name 参数 ， 图 片 默 认 路 径 为 /sdcard/Robotium-Screenshots/ 
id finishOpenedActivities() 
VO1 em 多 MREae i 
关闭 当前 已 打开 的 所 有 Activity 
goBackO / goBackToActivity(String name) 
点 击 返回 键 /不 断 地 点 击 返回 键 直 至 返回 到 指定 的 Activity 
. hideSoftKeyboard() 
Vold i 
收 起 健 本 
. setActivityOrientation(int orientation) 
void 


等 待 设置 Activity 转 屏 方向 


目 动 化 测试 过 程 中 ， 因 为 都 是 目 动 化 执行 的 ， 当 用 例 执行 失败 
时 ， 除 了 日 志 外 ， 最 方便 解决 定位 问题 的 就 是 运行 时 的 截图 ， 有 了 截 
图 定位 问题 往往 事半功倍 ，Robotium 中 提供 了 单 次 截图 及 截取 一 系列 
图 片 的 功能 。takeScreenshot () 方法 可 以 直接 截取 当前 屏幕 ， 并 将 其 
默认 地 保存 在 /sdcard/Robotium-Screenshots/ 目 录 下 ， 要 更 改 图 片 名 称 则 
使 用 takeScreenshot (String name) ， 要 截取 某 时 间 段 内 一 个 序列 的 话 
则 可 以 使 用 startScreenshotSequence (String name) 。 那 么 如 何 更 好 地 在 
自动 化 中 使 用 截图 功能 呢 ? 一 般 情 况 下 我 们 更 希望 的 是 在 用 例 执行 
败 时 进行 截图 ， 详 情 请 见 本 书 9.3.2 节 中 介绍 的 结合 Spoon 出 错 重 试 与 截 
图 o 


除了 沼 规 的 操作 外 ，Robotium 测 斌 框架 还 提供 了 发 送 模拟 按键 


sendKey (int key) 、 设 置 屏幕 是 横 屏 还 是 竖 屏 setActivityOrientation 
(int orientation) 、 模 拟 点 击 返 回 键 goBack () 、 跳 转 至 指定 Activity 

的 方法 goBackToActivity (String name) 、 收 起 输入 法 hideSoftKeyboard 
() 、 关 闭 所 有 已 打开 的 Activity 的 方法 finishOpenedActivities () 等 。 


通过 组 合 利用 这 些 闻 用 操作 ， 基 本 吏 可 以 完成 在 Android 站 的 UI 目 动 化 
操作 了 。 


3.WebView 支 持 


在 Android App 中 由 于 HTML 可 以 更 快 地 响应 变化 ， 而 不 像 Native 那 
样 需 要 发 布 版 本 才能 让 用 户 使 用 上 新 特性 ， 因 此 大 多 数 App 都 是 既 有 
Native 部 分 ， 也 有 HTML 部 分 ， 也 即 俗称 的 Hybrid App。 而 Robotium 在 
Robotium4.0 版 本 中 就 开始 全 面 支 持 WebView 的 自动 化 了 。 要 了 人 解 如 何 
使 用 Robotium 测 试 框架 来 对 App 中 的 WebView 部 分 进行 自动 化 测试 ， 首 
先 需要 了 解 HTML 基 础 ， 然 后 了 解 Robotium 是 如 何 获取 页 面 元 素 并 进行 
操作 的 。 


1) HTML 基 础 


Robotium 支 持 通 过 ID、className 等 方式 来 获取 WebElement 元 素 ， 
因此 ， 首 先 了 解 ID 、className 等 的 概念 ， 模 拟 打 开 GitHub 首 页 并 查看 
网 页 源码 如 图 3-12 所 示 。 


HTML 元 系 : 指 的 是 从 开始 标签 到 结束 标签 的 所 有 代码 。 如 图 3- 
12 所 示 ，Sign in 按 钮 在 开始 标签 <a href="/login"class="btn btn-block 


Primary"> 与 结束 标签 </a> 内 ， 因 此 整体 属于 一 个 HTML 元 么 。 


HIML 属 性 : 属性 总 是 以 名 称 / 值 对 的 形式 出 现 的 ， 比 如 : 
name="value"。 属 性 总 是 在 HTML 元 素 的 开始 标签 中 规定 的 。 核 心 属性 
有 class (规定 元 素 的 类 名 ) 、ID (规定 元 素 的 唯一 JD) 。Sign in 按钮 
中 就 有 class 属 性 ，class="btn btn-block primary" 。 


GitHub 三 Ns: 


v<html lane="en"> 
bp <head>-</head> 
vx<body class> 
Pp <header class="nav-bar">-</header> 


Where software Is <div id="js-flash-container"> 
built </div> 


vxdiv class="home-hero"》 


, <h1 class="home-heading">Where software is 
GitHub is the best place to share code with builit</hi> 


friends, co-workers, classmates, and vxp class="subheading"> 
complete strangers. Over 12 million people "GitHub is the best place to share code 


use GitHub to build amazing things together with friends, co-workers, classmates, and 
complete strangers. Over 12 million people 


use GitHub to build amazing things 
</p> 
<a href="/login™” class="btn btn-block 
primary">Sign in</a> 
</div> 
<div class="home-features">..</div> 
Youll love GitHub. pb <footer class="Cclearfix">.</footer> 
<script async="async” crossorigin="anonymous” 
GitHub is the largest code host on the src="https://assets-cdn.github. com/assets/ 

2 mobile- 
f99584ff113ffebg26f242fa49649571fd1ld48e271f46 
repositories and powerful tools 34ffe818986d65agd68. js"></scripty》 

</body> 
Collaborative code review with Puyll </html> 


Reguesis 


planet with over 30.3 million 


图 3-12” GitHub 首页 的 HTML 结 构 


2) WebElement 相 关 API 及 操作 


WebElement 相 关 API 见 表 3-9 。 


表 3-9 WebElement 相 关 API 


返回 值 方法 及 说 明 
getCurrentWebElements() 
ArrayList<WebElement> Ee en oe 
获取 当前 WebView 的 所 有 WebElement 元 素 


getCurrentWebElements(By by) 


AlirayList<WebElement> ri de em -4 
- 通过 By 根据 指定 的 元 素 属 性 获取 当前 WebView 的 所 有 WebElement 元 素 


clickOnWebElement(By by) 


void A 
通过 By 根据 指定 的 元 素 属 性 点 击 WebElement 
id clickOnWebElement(WebElement webElement) 
Vol op 
点 击 指定 的 WebElement 
enterTextInWebElement(By by, String text) 
void 、 3 
根据 by 找到 WebElement， 并 输入 指定 的 文本 text 
waitForWebElement(By by) 
boolean 


等 待 根据 by 获得 的 WebElement 出 现 


在 Robotium 中 对 WebElement 进 行 操作 有 两 种 方式 ， 一 种 是 先 获取 
相应 的 WebElement， 然 后 发 送 点 击 事件 ， 另 一 种 则 是 直接 调用 
clickOnWebElement (By by) 进行 点 击 。 


在 获取 WebElement 元 素 前 我 们 首先 需 要 知道 这 个 页 面 的 HTML 结 
构 ， 需 要 知道 URL 链 接 才 能 方便 地 查看 HTML 元 素 、 属 性 等 。 


获取 WebView 中 的 页 面 信息 可 以 参考 本 书 6.3.3 订 Appium 脚 本 和 常见 
问题 及 处 理 方法 中 如 何 获 取 WebView 中 的 页 面 信息 这 一 部 分 内 容 ， 通 
过 Chrome 浏 贤 絮 中 的 DevTools 工 具 可 以 快速 方便 地 查看 WebView 中 的 
主 自 。 


百 / 心 ， 


我 们 也 可 以 使 用 原始 的 如 代码 清单 3-3 所 示 的 方式 打印 出 所 有 的 元 
素 信 息 。 


代码 清单 3-3 ”使 用 日 志 打 印 方式 获取 元 素 信 息 


ArrayList<webElement> webElements = solo.getCurrentwebElements(); 
WebElement webElement = null,; 
for(int i=0;i< webElements.size();i++){ 
webElement = webElements.get(i); 
Log.i("WebElement", "getId:" + webElement.getId()); 
Log.i("WebElement","getClassName:"+webElement.getClassName( )); 
Log.i ("webElement", "getText:" + webElement.getText()); 


当 我 们 知道 了 相应 页 面 的 元 素 、 属 性 后 ， 束 可 以 通过 元 素 或 属性 
等 信息 来 获取 指定 的 WebElement 。 


1) 获取 当前 WebView 所 有 WebElement 


ArrayList<webElement> webElements = solo.getCurrentwebElements(); 


2) 通过 className 获 取 


ArrayList<webElement> signIns = solo.getCurrentwebElements(By 
.ClassName("btn btn-block primary")); 


3) 通过 ID 获取 


ArrayList<webElement> signIns = solo.getCurrentwebElements(By 
.id("example_id")); 


4) 通过 textContent 获 取 


ArrayList<webElement> signIns = solo.getCurrentwebElements(By 
,textContent("Sign in")); 


类 似 的 还 有 通过 cssSelector、name、tagName、xpath 等 方式 获取 。 


5) 通过 WebElement 点 击 


拿 到 WebElement 后 ， 如 果 在 页 面 中 该 标识 是 唯一 的 ， 那 么 数组 长 
度 为 1， 可 以 通过 clickOnWebElement (WebElement webElement) 方法 
比较 精确 地 点 击 。 


solo.clickOnwebElement(signIns.get(0)); 


以 上 获取 WebElement 并 点 击 也 可 以 直接 使 用 clickOnWebElement 
(Byby) 方法 完成 。 


solo.clickOnwebElement(By.className("btn btn-block primary")); 


6) WebElement 输 入 


solo.enterTextInwebElement(By.name("userId"), "your username"); 
solo.enterTextInwebElement(By.name("passwd"), "your passwd"); 


同样 地 ，WebElement 也 支持 等 得 操作 ， 可 以 通过 
waitForWebElement (By by) 等 待 相应 的 元 素 出 现 ， 然 后 查找 ， 这 样 可 
以 使 脚本 更 健壮 。 不 过 Robotium 中 的 clickOnTx-WebElement (By by) 
也 均 默 认 已 经 使 用 了 等 待机 制 ， 因 此 非特 殊 情 况 ， 脚 本 中 不 需要 额外 
增加 等 待 操作 。 


@ 注音 ”Robotium 中 对 WebView 的 支持 由 于 是 使 用 对 系统 
WebView 执 行 JS 从 而 封装 获取 页 面 元 素 的 方式 ， 因 此 该 测试 框架 只 支持 
App 中 使 用 系统 WebView 的 情况 ， 如 果 App 或 浏览 器 使 用 的 是 非 系 统 
核 的 WebView， 例 如 腾讯 手机 QQ 浏览 器 的 X5 内 核 ， 则 无 法 使 用 ， 需 
引用 X5 的 SDK 并 对 Robotium 进 行 改造 才 可 支持 。 


4 呆 言 


目 动 化 测试 中 ， 我 们 获取 控件 、 执 行 操作 后 ， 接 下 来 就 是 要 对 操 
作 后 的 场景 进行 断言 了 。Robotium 是 基于 Instrumentation 的 测试 框 织 ， 
其 测试 用 例 编写 的 框架 是 基于 Junit 的 ， 因 此 ， 本 小 市 将 先 介 绍 Junit 中 
的 断言 ， 然 后 介绍 Robotium 中 适用 于 Android 痕 目 动 化 的 断言 。 


1) Junit 中 的 断言 


Junit 中 的 断言 相关 API 见 表 3-10。 


表 3-10 Junit 中 的 断言 相关 API 


返回 值 方法 及 说 明 
id assertTrue(String message, boolean condition) 

VO1 sy 1 a 2 Rf - 村 二- | = LF 3 ev 
放言 传人 的 condition 参数 应 该 为 True， 和 否则 将 抛 出 一 个 带 有 message 提示 的 Throwable 异常 
jd assertFalse(String message. boolean condition) 

VoO1l 2 ft 上 i Ss Rf Fe - 在 4 2 .| 3 le 
潜 言 传人 的 condition 参数 应 该 为 False， 否 则 将 抛 出 一 个 带 有 message 提示 的 Throwable 异常 
fail(String message) 


void ee , en he em ee 
直接 使 用 例 失 败 ， 并 抛 出 一 个 带 有 message 提示 的 Throawable 异常 


Junit 中 的 断言 可 以 查看 Android SDK 中 junit.framework.Assert 包 下 的 
Assert 类 ， 常 用 的 有 assertTrue (String message，boolean condition) 方 
法 ， 即 断言 方法 中 第 二 个 参数 condition 的 结果 是 否 为 True， 如 果 为 True 
则 该 语句 执行 通过 ， 否 则 该 语句 将 抛 出 Throwable 的 异常 ， 而 异常 中 的 
提示 语 将 为 第 一 个 参数 message。 因此， 使 用 断言 时 ， 应 该 准确 明了 地 
说 明 message 人 参数， 以 便 断 言 不 符合 预期 时 可 以 快速 判断 是 什么 原因 导 
致 的 。 例 如 断言 某 个 控件 应 该 要 显示 在 界面 中 ， 代 码 如 下 : 


Button loginBtn = (Button) solo.getView("loginBtn"); 
assertTrue(" 登录 "按钮 应 该 要 显示 在 界 再 


", loginBtn.isShown()); 


同样 地 ， 还 有 assertFalse (String message，boolean condition) 方 
法 ， 用 于 断言 第 二 个 条 件 中 的 结果 应 该 为 False。 通 过 这 两 个 方法 ， 只 
要 测试 过 程 中 的 预期 结果 能 转换 成 True 或 False 的 都 可 以 进行 判断 ， 例 
如 判断 界面 元 素 是 否 显示 、 数 值 大 小 比较 、 文 本 对 比 等 。 


在 测试 工程 中 ， 当 出 现 某 种 场景 时 ， 有 时 我 们 希望 直接 使 用 例 失 
败 而 不 再 往 下 执行 ， 此 时 可 以 使 用 Assert 类 中 的 fail (String message) 
方法 ， 例 如 : 


if(isBadHappened()){ 
fail("this should no happened"); 
} 


而 如 果 出 现 某 种 场景 ， 我 们 和 希望 直接 使 用 例 通 过 而 不 再 执行 ， 则 
此 时 在 用 例 脚 本 中 直接 使 用 return 即 可 。 


2) Robotium 中 的 断言 
Robotium 中 的 断言 相关 API 见 表 3-11。 


表 3-11 ”Robotium 中 的 断言 相关 API 


返回 值 方法 及 说 明 
assertCurrentActivity(String message, String name) 
void 断言 当前 界面 是 否 为 name 参数 指定 的 Activity， 若 不 是 则 抛 出 一 个 带 有 message 提示 的 
Throwable 异常 
有 assertMemoryNotLow() 
void oe eee ope 
断言 当前 是 否 处 于 低 内 存 状 态 


Robotium 基 于 Junit 中 的 断言 判断 ， 也 封装 了 几 个 方便 在 Android 端 
自动 化 时 使 用 的 断言 方法 。 例 如 assertCurrentActivity (String message， 
String name) 方法 可 以 判断 当前 界面 是 否 是 预期 的 Activity， 我 们 知道 
Android 中 许多 页 面 都 对 应 于 一 个 Activity， 当 App 跳 转 到 一 个 界面 时 ， 
就 可 以 使 用 该 方法 来 判断 是 否 已 跳 转 到 相应 Activity 了 。 


/ /获取 当前 的 


Activity 名 


String currentActivity = 
solo.getCurrentActivity().getclass().getSsimpleName( ); 


// expectedActivity 为 期 望 跳 转 的 


Activity 
solo.assertCurrentActivity("expected xxxActivity" + " but was 


expectedActivity); 


" + currentActivity, 


另外 ， 测 试 框架 中 的 assertMemoryNotLow () 方法 可 以 用 来 判断 
当前 是 否 处 于 内 存 吃紧 的 情况 。 在 Robotium 封 装 的 断言 API 并 不 多 ， 
为 如 前 文 所 说 ， 大 多 数 场景 都 可 以 使 用 True 或 False 来 进行 判断 。 


3) Android 中 的 断言 


Android 中 的 断言 相关 API 见 表 3-12 。 


表 3-12 ” Android 中 的 断言 相关 API 


返回 值 方法 及 说 明 
. assertOnScreen(View origin, View view) 

void 人 
断言 view 是 否 在 屏幕 中 
assertBottomAligned(View first, View second) 


void ei Rp re es 本 
断言 两 个 view 是 否 底 端 对 齐 ， 即 它们 的 底 端 y 坐标 相等 


在 Android SDK 中 ，android.test.ViewAsserts 包 下 有 个 ViewAsserts 类 
可 以 方便 地 进行 与 控件 相关 的 断言 。 例 如 断言 控件 是 否 在 窗口 中 


assertOnScreen (View origin，View view) ， 上 断言 两 个 控件 是 否 底部 对 


齐 assertBottomAjligned (View first，View second) ， 是 否 右 对 齐 
assertRightAligned (View first，View second) ， 等 等 。 而 之 所 以 能 实现 
这 些 断 言 在 于 View 控 件 本 号 束 具有 非常 多 的 可 以 用 于 判断 目 身 状态 的 
属性 ， 例 如 View 可 以 判断 自身 是 否 显 示 isShown () ， 判 断 是 否 被 选中 
isSelected () ， 还 可 以 获取 自身 所 在 的 坐标 位 置 getLocationOnScreen 
(int[Jlocation) 和 宽 高 getWidth () 、getHeight () ， 等 等 。 由 于 基于 
Robotium 编 写 的 测试 用 例 是 以 App 形 式 安装 进 手机 的 ， 且 运行 时 是 运行 


在 被 测 应 用 所 在 的 进程 ， 因 此 我 们 使 用 断言 时 ， 可 以 借助 Android SDK 
中 丰富 的 类 库 来 进行 各 种 判断 ， 例 如 判断 当前 网 络 状 态 、 应 用 安装 情 
况 、 当 前 应 用 是 否 处 于 前 台 等 ， 可 以 很 方便 地 对 测试 的 预期 结 

判断 。 如 代码 清单 3-4 所 示 ， 调 用 Android 中 的 API 根 据 包 名 判断 是 否 是 
系统 应 用 。 


代码 清单 3-4 ”根据 包 名 判断 是 否 钙 系统 应 用 


A 
* 根据 


packageName 判 断 该 应 用 是 否 是 系统 应 


* @param packageName 应 用 的 包 名 


* @return true,， 系统 应 用 ; 


false， 非 系统 应 上 


*/ 
public boolean isSystemApp(String packageName){ 

PackageManager pm = 
getInstrumentation().getTargetContext().getApplicationContext().getPpackageManager( 
); 

ApplicationInfo applicationInfo = null; 

try { 

applicationInfo = pm.getApplicationInfo(packageName, 
PackageManager .GET_UNINSTALLED_PACKAGES ) ， 
if(applicationInfo !=null && (applicationInfo.flags & 
ApplicationInfo.FLAG_SYSTEM) ==1){ 
LogUtils.1logD(TAG, "applicationInfo flag:" + (applicationInfo.flags & 
ApplicationInfo.FLAG_ SYSTEM)); 
return true; 


} catch (NameNotFoundException e) { 


return false,; 


3.2 ”Robotium 原 理 简 析 


如 前 文 所 述 ， 一 个 基本 的 上 自动 化 测试 用 例 主要 分 为 获取 控件 、 控 
件 操作 、 断 言 三 个 步 台 ， 而 在 实际 编写 测试 用 例 的 过 程 中 ， 我 们 常常 
会 过 到 各 种 各 样 的 问题 ， 比 如 : 


-在 这 样 的 UI 结构 下 该 如 何 获 取 控 件 ? 


:为何 报 这 样 或 那样 的 错 ? 


.明明 滑动 了 为 何 没有 效 采 ? 


因为 不 同 的 项 目 有 其 自身 的 独特 性 与 复杂 性 ， 没 有 任何 书籍 可 以 
解决 实际 过 程 中 遇 到 的 所 有 问题 ， 甚 至 即使 求助 Google 搜 索 也 可 能 得 
不 到 自己 想 要 的 答案 。 因 此 ， 对 于 任何 一 门 技术 而 言 都 很 有 必要 知 其 
然 并 知 其 所 以 然 ， 只 有 了 解 了 其 原理 实现 ， 才 能 更 高 效 地 运用 在 实际 
项 目 中 。 本 节 将 从 获取 控件 原理 、 控 件 操 作 原 理 、WebView 文 持 等 维 
度 来 对 Robotium 原 理 进行 简要 解析 。 


3.2.1 Robotium 支 持 Native 原 理 


1. 获 取 控 件 原理 


我 们 知道 Android 会 为 res 目 录 下 的 所 有 资源 分 配 ID， 例 如 在 布局 
xml 文 件 中 使 用 了 android: id="@+id/example id"， 那 么 在 Android 工 
程 编译 时 就 会 在 R.java 中 相应 地 为 该 布局 控件 分 配 一 个 int 型 的 ID， 在 
Android 工 程 中 就 可 以 通过 Activity、Context 或 View 等 对 象 调用 
findViewById (int id) 方法 引用 相应 布局 中 的 控件 。 因 此 ， 在 测试 工 
程 中 ， 如 果 是 在 源码 的 情况 下 ， 测 试 工程 可 以 引用 被 测 工程 的 代码 ， 
也 即 可 以 直接 获得 被 测 工程 中 R.java 中 的 ID， 因 此 可 以 通过 这 种 方式 
直接 根据 ID 获取 控件 。Robotium 中 根据 ID 获取 控件 的 实现 即 包含 该 方 
式 ， 如 代码 清单 3-5 所 示 。 


代码 清单 3-5 Getter.getView 


public View getView(int id, int index, int timeout ){ 
final Activity activity = activityUtils.getCurrentActivity(false); 
View viewToReturn = null; 
/ /如 果 


index 小 于 

工 ， 则 直接 通过 
Activity 的 
findViewById 查 找 


if(index < 1){ 
index = 0; 


ViewToReturn = activity.findViewById(id); 


if (viewToReturn != nul1) { 
return ViewToReturn 


return waiter.waitForView(id, index, timeout); 


} 


在 getView (int id，int index，int timeout) 方法 中 ， 先 获取 当前 所 
在 的 Activity， 然 后 直接 通过 findViewById (id) 方法 党 试 获取 控件 ， 
如 有 果 该 方法 能 够 正确 获取 ， 则 直接 返回 ， 否则 ， 使 用 waitForView 

(id，index，timeout) 方法 进一步 等 待 控件 的 出 现 。 


对 于 测试 工程 没有 关联 被 测 工程 的 情况 ， 是 无 法 直接 通过 
R.id.example_ id 的 形式 获取 控件 的 ， 此 时 一 般 调 用 getView (String id) 
方法 ， 即 通过 String 型 ID 获取 。 之 所 以 可 以 通过 String 型 ID 获取 控件 ， 
是 因为 Robotium 中 该 方法 使 用 了 Resources.getIdentifier (String name， 
String defType，String defPackage) 方法 动态 地 将 String 型 ID 转换 成 了 
int 型 ID， 如 代码 清单 3-6 所 示 。 


代码 清单 3-6 Getter.getView (String id，int index) 


public View getView(String id, int index){ 
View viewToReturn = null; 
Context targetContext = instrumentation.getTargetContext(); 
String packageName = targetContext ,getPackageName( ); 
// 先 将 


String 类 型 的 
ID 转 换 成 

int 型 的 

ID 


int viewId = targetContext.getResources().getIidentifier(id, "id", 
packageName ) ， 


if(viewId != 0){ 
viewToReturn = getView(viewId, index, TIMEOUT); 


/ /如果 还 未 找到 ， 则 传 入 的 


ID 可 能 是 


Android 系 统 中 的 


ID 
if(viewToReturn == null)t{ 
int androidViewId = targetContext.getResources().getIdentifier(id, "id", 
"android"); 
if(androidViewId != 0){ 
ViewToReturn = getView(androidViewId, index, TIMEOUT); 
} 


if(viewToReturn != null)t{ 
return ViewToReturn 
} 


return getView(viewId, index); 


因此 ， 为 了 简化 操作 ， 我 们 完全 可 以 统一 使 用 getView (String 
id) 方法 来 获取 控件 。 


以 上 为 根据 ID 获取 控件 的 一 种 方式 ， 另 一 种 方式 则 是 通 
WindowManager 获 取 所 有 View 后 再 进行 各 种 过 小 封 效 。 如 代码 清单 3-7 
所 示 ， 在 ViewFetcher 中 通过 getAllViews 方 法 获取 所 有 的 View， 其 中 分 


别处 理 DecorView 与 nonDecorView 。 
代码 清单 3-7 ViewFetcher.getAllViews 


public ArrayList<View> getAllViews(boolean onlySufficientlyVisible) { 
/ /获取 所 有 的 


DocorViews 
final View[] views = getWindowDecorViews(); 
final ArrayList<View> allViews = new ArrayList<View>(); 
final View[] nonDecorViews = getNonDecorViews (views); 
View view = null,; 
if(nonDecorViews != null)t{ 
for(int i = 0; i < nonDecorViews.length; i++){ 
View = nonDecorViews[i]; 


try { 
addchildren(allViews, (ViewGroup)view, onlySufficientlyVisible); 


} catch (Exception ignored) 人 } 
if(view != null) allViews.add(view); 


} 


If (views != null && views.length > 0) { 
View = getRecentDecorView(views); 


try { 
addchildren(allViews, (ViewGroup)view, onlySufficientlyVisible); 


} catch (Exception ignored) 人 {} 
if(view != null) allViews.add(view); 


return allViews; 


如 代码 清单 3-8 所 示 ， 在 getWindowDecorViews 方 法 中 通过 使 用 反 
射 获 取 Window-Manager 中 的 mViews 对 象 来 获取 所 有 DecorView， 其 中 
也 可 以 看 到 对 于 Android 系 统 版 本 大 于 19 的 处 理 是 不 同 的 。 


代码 清单 3-8 ViewFetcher.getWindowDecorViews 


@Suppresswarnings("unchecked") 
public View[] getwindowDecorViews() 


Field viewsField; 
Field instanceField; 


try { 
/ /通过 反射 获取 


WindowManagerGlobal 或 


WindowManagerImpl 中 的 
mViews 变 量 

viewsField = windowManager .getDeclaredField("mViews"); 
/ /通过 反射 获取 


WindowManagerGlobal 或 


ey 


WindowManagerImpl 中 和 
WindowManager 实 例 的 变量 
instanceField = windowManager .getDeclaredField(windowManagerSstring); 


viewsField,.setAccessible(true); 
instanceField.setAccessible(true); 


Object instance = instanceField.get(null); 
View[] result 
if (android.os,Build,VERSION,SDK_INT >= 19) { 
result = ((ArrayList<View>) viewsField.get(instance)).toArray(new 
View[0]); 
} else { 
result = (View[]) viewsField.get(instance); 


return result; 
} catch (Exception e) { 
e,.printStackTrace( ); 


return null; 


} 


再 看 代码 清单 3-9 中 的 WindowManagerString 变 量 的 来 源 ， 如 代码 
清单 3-9 所 示 ，WindowManagerString 也 同样 地 需要 根据 Android 系 统 
本 的 不 同 而 分 别处 理 。 


代码 清单 3-9 ViewFetcher.setWindowManagerString 


private void setwindowManagerString()t{ 
/ /不 同 的 系统 版 本 ， 


WindowManager 的 变量 名 不 同 


If (android.os.Build.VERSION.SDK_INT >= 17) { 


windowManagerString = "sDefaultwindowManager"; 
} else if(android.os,.Build.VERSION.SDK_INT >= 13) { 
windowManagerString = "swWwindowManager"; 
} else { 
windowManagerString = "mwWindowManager"; 


至 此 我 们 知道 了 Robotium 中 获取 所 有 Views 是 通过 反射 机 制 实现 
的 ， 而 源码 中 的 变量 很 可 能 根据 版 本 的 不 同 而 改变 ， 因 此 通过 反射 则 
往往 需 根据 系统 版 本 的 不 同 而 分 别处 理 。 所 以 ， 使 用 Robotium 时 最 好 


使 用 开源 项 目 中 的 最 新 版 本 ， 因 为 当 有 新 的 Android 系 统 版 本 发 布 时 ， 
很 可 能 Robotium 也 需要 与 时 俱 进 地 完善 获取 控件 方式 。 


2. 控 件 操 作 原 理 


Robotium 获 取 探 件 后 ， 调 用 clickOnView (View view) 方法 就 可 
以 完成 点 击 操作 ， 这 个 方法 可 以 实现 两 大 功能 


-根据 View 获 取 了 控件 在 屏幕 中 的 坐标 。 


-根据 坐标 发 送 了 模拟 的 后 击 操作 。 


如 代码 清单 3-10 所 示 ， 由 于 View 本 喘 可 以 获取 到 在 屏幕 中 的 起 始 
坐标 与 控件 长 宽 ， 因 此 通过 getLocationOnScreen 获 取 起 始 坐标 后 ， 再 
加 上 1/2 的 长 与 宽 ， 即 可 计算 出 控件 的 中 心 点 在 屏幕 中 的 位 置 。 


代码 清单 3-10 ”Clicker.getClickCoordinates 


private float[] getClickcoordinates(View View){ 
sleeper.sleep(200); 
int[] xyLocation = new int[2]; 
float[] xyToClick = new float[2]; 
/ /获取 


VIew 的 坐标 ， 
xyLocation[0] 为 


X 坐 标的 值 ， 


xyLocation[1] 为 


y 坐 标的 值 


view.getLocationOnscreen(xyLocation); 


final int viewWidth = view.getWwidth(); 
final int viewHeight = view.getHeight(); 
//XyLocation 中 的 值 为 控件 左上 角 的 坐标 ， 因 此 


XxXyLocation[0]+ 宽 长 除 
2 即 为 该 控件 在 
X 轴 的 中 


心 点 ， 同 样 地 计算 在 


y 轴 的 中 心 点 


final float x = xyLocation[0] + (viewWidth / 2.0f); 
float y = xyLocation[1] + (viewHeight / 2.0f); 
xyToClick[0] = x; 

xyToClick[1] = y; 

return xyToClick,; 


知道 了 需要 点 击 的 位 置 后 ， 那 么 接 下 来 发 送 模拟 点 击 就 可 以 了 。 
Android 中 的 模拟 操作 可 以 通过 MotionEvent 来 实现 ， 而 MotionEvent 主 
要 有 以 下 三 种 形式 ; 


.MotionEvent.ACTION_DOWN: 模拟 对 屏幕 发 送 下 按 事 件 。 


.MotionEvent.ACTION_UP: 模拟 对 屏幕 发 送 上 抬 事 件 。 


.MotionEvent.ACTION_MOVE: 模拟 对 屏幕 发 送 移动 事件 。 


Robotium 中 的 点 击 屏幕 方法 即 是 通过 MotionEvent 实 现 的 ， 如 代码 
清单 3-11 所 示 ， 通 过 MotionEvent.obtain (long downTime，long 
eventTime，int action，float x，float y，int metaState) 方法 获取 相应 的 
event 事 件 后 ， 再 通过 Instrumentation 的 sendPointerSync (MotionEvent 


event) 方法 将 event 事 件 实 际 地 在 手机 上 模拟 执行 。 


代码 清单 3-11 Clicker.clickOnScreen 


public void clickOnscreen(float x, float y, View view) { 
boolean successfull = false; 
int retry = 0; 
SecurityException ex = null; 
while(!successfull && retry < 20) { 
long downTime = SystemClock.uptimeMillis(); 
long eventTime = SystemClock.uptimeMillis(); 
MotionEvent event = MotionEvent.obtain(downTime, eventTime, 
MotionEvent.ACTION_ DOWN, x, y, 0); 
MotionEvent event2 = MotionEvent.obtain(downTime, eventTime, 
MotionEvent .ACTION_UP, x, y, 0); 


Instrumentation 模 拟 发 送 下 按 操作 


inst.sendPointerSync(event); 
// 通 过 


Instrumentation 模 拟 发 送 上 抬 操 作 ， 与 下 按 操作 结合 ， 模 拟 完成 了 一 个 点 击 过 程 


inst.sendPointerSync(event2); 
successfull = true; 
}catch(SecurityException e){ 
ex = e; 
dialogUtils.hideSoftkeyboard(null, false, true); 
sleeper.sleep(MINT_ WAIT); 
retry++， 
View identicalView = viewFetcher.getIidenticalView(view); 
if(identicalView != null){ 
float[] xyToClick = getClickCoordinates(identicalView); 
x = xyToClick[0]; 
y = xyToClick[1]; 


} 


/ /如 果 点 击 失败 ， 将 抛 出 异常 


if(!successfull) { 
Assert.fail("Click at ("+x+", "+y+") can not be completed! ("+(ex != null 
? ex.getCclass().getName()+": "+ex.getMessage() : "null")+")"); 


} 
} 


结合 getClickCoordinates (View view) 与 clickOnScreen (float X， 


float y，View view) 方法 就 完成 了 dickOnView (View view) 方法 的 核 


心 实现 。 通 过 控制 不 同 手势 操作 的 时 间 顺 序 还 可 以 模拟 各 种 手势 操 
作 ， 例 如 先 发 送 MotionEvent.ACTION_DOWN， 一 段 时 间 后 ， 再 发 送 
MotionEvent.ACTION_UP 就 模拟 了 长 按 操作 。 先 发 送 
MotionEvent.ACTION_DOWN， 然 后 发 送 
MotionEvent.ACTION_MOVE， 最 后 发 送 MotionEvent.ACTION_UP 就 
是 滑动 操作 了 。 因 此 ， 结 合 MotionEvent 的 各 种 模拟 事件 也 可 以 自行 实 
现 自 定义 的 手势 操作 。 


3.2.2 ”Robotium 支 持 WebView 原 理 


在 上 一 节 中 我 们 介绍 了 在 Robotium 中 如 何 通 过 By.id 或 By.className 
方式 获取 Web-Element， 那 么 Robotium 中 是 如 何 获取 到 相应 的 HIML 元 
系 ， 并 能 知道 元 素 坐 标 ， 从 而 发 送 点 击 事件 的 呢 ? 


1.WebElement 对 象 


Robotium 中 以 WebElement 对 象 对 HTML 元 素 进 行 了 封装 ， 在 这 个 
WebElement 对 象 中 包含 locationX、locationY 、ID 、text、name、 


className、tagName 等 信息 。 


,locationX、locationY: 标识 该 HTML 元 素 在 屏幕 中 所 在 的 XX 坐标 和 
Y 坐 标 。 


.ID 、className: 该 HTML 元素 的 属性 。 
-tagName: 该 HTML 元 素 的 标签 。 


Robotium 中 封装 了 WebElement， 提 供 了 dickOnWebElement 
(WebFlement webElement) ， 


ArrayList<WebElement>getCurrentWebElements () 等 操作 Web 元 素 的 


API， 对 于 在 Android 客 户 端 中 展示 的 Web 页 面 ，Robotium 是 如 何 把 里 面 
的 元 素 都 提取 出 来 ， 并 封装 进 WebElement 对 象 中 的 呢 ? 


如 图 3-13 所 示 ， 通 过 getWebElements 方 法 的 调用 关系 图 可 以 看 出 ， 
Robotium 主 要 通过 JS 注入 的 方式 获取 Web 页 面 所 有 的 元 素 ， 再 对 这 些 元 
素 进 行 提 取 并 封装 成 WebElement 对 象 。 在 Android 端 与 JS 交互 则 离 不 开 


WebView 和 WebCromeClient °。 


WebUtils. getWebElements 
WebUtils. executeJavaScriptFunction 


WebUtils. prepareForStartO0f JavascriptExecution 
WebUtils. get JavaScriptAsS txing | 


WebUtils. getCurrentWebChromeClient 


WebUtils. getWebElements 


\ 
WebElementCreator. getWebELementsFromWebViews 


WebElementCreator. i1sWebElementSufficientlyShown 
WebElementCreator. waitForWebElementsToBeCreated 
WebElementCreator. isFinished 


图 3-13 ”getWebElements 方 法 的 调用 天 系 图 


2.WebElement 元 素 获 取 


1) 利用 JS 获取 页 面 中 的 所 有 元 素 


在 PC 上 ， 获 取 网 页 的 元 于 可 以 通过 注入 javascript 元 素来 完成 ， 以 
Chrome 浏 览 器 为 例 ， 打 开工 具 一 一 JavaScript 控 制 台 (快捷 方式 : 
Ctrl+Shift+J 键 ) ， 输 入 javascript: prompt (document.URL) 即 会 弹出 
含 当 前 页 面 的 URL 的 提示 框 ， 因 此 通过 编写 适当 的 JS 脚 本 就 可 以 在 这 
个 弹出 框 中 显示 所 有 的 页 面 元 素 。RobotiumWeb.js 就 提供 了 获取 所 有 
HTML 元 素 的 JS 脚 本 。 以 Solo 中 getWebElements () 为 例 ， 如 代码 清单 
3-12 所 示 ， 可 分 为 两 步 ， 先 通过 executeJavaScriptFunction () 方法 执行 
JS 脚本 ， 然 后 根据 执行 结果 通过 getWebElements 返 回 。 


代码 清单 3-12 ”WebUtils.getWebElements 


public ArrayList<WebElement> getwebElements(boolean onlySufficientlyVisible){ 
boolean javaScriptwasEXxecuted = 
executeJavascriptFunction("allwebElements();'" 
return ete et onlySufficientlyVisible); 
} 


如 代码 清单 3-13 所 示 ， 在 executeJavaScriptFunction (final String 
function) 方法 中 通过 webView.loadUrl (String url) 方法 执行 JS， 而 这 
里 的 WebView 是 通过 getCurrentViews (Class<T>classToFilterBy, 
boolean includeSubclasses) 过 滤 出 来 的 ， 且 是 过 滤 的 


android.webkit.WebView， 这 也 是 Robotium 只 支持 系统 WebView 而 不 支 
持 第 三 方 浏 贤 内 核 中 的 WebView 的 原因 : 


代码 清单 3-13 WebUtils.executeJavaScriptFunction 


private boolean executeJavaScriptFunction(final String function) { 
List<webView> webViews = viewFetcher.getCurrentViews(WebView.class, true); 
/ /获取 当前 屏幕 中 最 新 的 


WebView， 即 目标 要 执行 
JS 的 


WebView 
// 注 : 这 里 获取 的 


WebView 可 能 不 是 目标 
WebView， 那 么 将 导致 获取 
WebElement 失 败 

final WebView webView = viewFetcher.getFreshestView( (ArrayList<wWebView>) 
webViews ) ， 

if(webView == null) { 

return false; 
} 


// 执 行 


JS 前 的 准备 工作 ， 如 设置 


WebSettings、 获 取 


JS 方法 等 


final String javaScript = 
setwebFrame(prepareForStartofJavascriptExecution(webViews ) ) ， 
Inst,runonMainSync(new Runnable() { 
public void run() { 
if(webView != null)f{ 


// 调 
loadUr1 执 行 
JS 
webView.loadUrl("javascript:" + javaScript + function); 
} 
} 
}); 


return true; 


想 返 回 什 么 样 的 结果 ， 关 键 在 于 执行 了 什么 样 的 JS 方法 ， 
() 执行 的 JS 方法 是 alWebElements 
() ， 代 码 片 段 可 以 通过 RobotiumWeb.js 找 到 ， 如 代码 清单 3-14 所 示 ， 
采用 遍历 DOM 的 形式 获取 所 有 的 元 素 信息 。 


代码 清单 3-14 ”RobotiumWeb.js 中 的 allWebElements () 


function allwebElements() { 
for (var key in document .al1){ 


try{ 
promptElement(document.all[key]); 
}catch(ignored){} 


finished(); 
} 


如 代码 清单 3-15 所 示 ， 将 代码 清单 3-15 中 遍历 获取 到 的 每 一 个 元 素 
分 别 获取 ID、text、className 等 ， 然 后 将 元 素 通 过 prompt 方 法 以 提示 框 
形式 显示 。 在 prompt 时 ， 会 在 ID、text、className 等 字段 之 间 加 
上 '，，' 和 将 殊 字 符 ， 以 便 解 析 时 区 分 这 几 个 字段 。 


代码 清单 3-15 ”RobotiumWeb.js 中 的 promptElement (element) 


function promptElement(element) { 
var id = element.id; 
Var text = element .InnerText ， 
if(text.trim().length == 0){ 
text = element.value,; 


var name = element.getAttribute('name'); 
var className = element.className,; 
var tagName = element .tagName; 
Var attributes = "",，; 
var htmlAttributes = element .attributes ， 
for (var i = 0, htmlAttribute; htmlAttribute = htmlAttributes[i]; i++){ 
attributes += htmlAttribute.name + "::" + htmlAttribute.value,; 
if (i + 1 < htmlAttributes.]length) { 
attributes += "#$"， 


} 


var rect = element.getBoundingClientRect(); 
if(rect.width > 0 && rect.height > 0 && rect,left >= 0 && rect.top >= 0){ 
prompt(id + ';,' + text + ';,' + Name + ";," + ClassName + " 
+ ";," + rect.left + ';,' + rect.top + 
';,' + attributes)， 


;," + tagName 
';,' + rect.width + ';,' + rect.height + 


最 后 ， 执 行 finished () 方法 ， 调 用 prompt 提 示 框 ， 提 示 语 为 特定 
的 robotium-finished'， 用 于 在 Robotium 执 行 JS 时 ， 判 断 是 否 执行 完毕 ， 
如 代码 清单 3-16 所 示 。 


代码 清单 3-16 ”RobotiumWeb.js 中 的 finished () 


function finished(){ 
//robotium-finished 用 来 标识 


Web 元 素 遍历 结束 


prompt( 'robotium-finished ' )， 


通过 JS 完 成 了 Web 页 面 所 有 元 素 的 提取 ， 提 取 的 所 有 元 于 是 以 
prompt 方 式 显 示 在 提示 框 中 的 ， 那 么 提示 框 中 包含 的 内 容 在 Android 中 
经 么 获取 呢 ? 


2) 通过 onJsPrompt 回 调 获取 prompt 提 示 框 中 的 信息 


如 代码 请 单 3-17 所 示 ， 通 过 JS 注入 获取 到 Web 页 面 所 有 的 元 系 后 ， 
可 以 通过 onJsPrompt 回 调 来 对 这 些 元 素 进 行 提 取 。Robotium 写 了 个 继承 
自 WebChromeClient 类 的 RobotiumWebClient 类 ， 禾 写 了 onJsPrompt 用 于 


回调 提取 元 素 信息 ， 如 果 提 示 框 中 包含 “robotium-finished” 字 符 串 ， 即 
表示 这 段 JS 脚本 执行 完毕 了 ， 此 时 通知 webElementCreator 可 以 停止 等 
待 ， 否 则 ， 将 不 断 将 prompt 杠 中 的 信息 交 由 
webElementCreatorcreateWeb-ElementAndAddInList 解 析 处 理 。 


代码 清单 3-17 RobotiumWebClient 中 的 onJsPrompt 


Q@Override 
public boolean onJsPrompt (WebView view, String url, String message, String 
defaultValue, JsPromptResult r) { 
// 当 
message 包 含 
robotium-finishedH 时 ， 表示 


JS 执 行 结束 


if(message != null && (message.contains(";,") || message.contains("robotium- 
finished")))t{ 
if(message.equals("robotium-finished"))t{ 
//setFinished 为 


true 后 ， 


WebElementCreator 将 停止 等 待 


webElementCreator.setFinished(true); 


} 
elsef 
webElementCreator.createwebElementAndAddInList(message, view); 


r.confirm(); 
return true; 
} 
else { 
if(originalwebChromeClient != null) { 
return originalwebChromeClient.onJsPrompt(view, url, message, 
defaultValue, r); 


return true; 


3) 将 回调 中 获取 的 元 素 信息 封装 进 WebElement 对 象 中 


获取 到 onJsPrompt 回 调 中 的 元 素 信 息 后 ， 接 下 来 天 可 以 对 这 


文 些 已 经 


过 处 理 、 含 特殊 格式 的 消 明 进 行 解析 了 ， 依 次 得 到 WebElement 的 ID 、 


text、name 等 字段 。 如 代码 清单 3-18 所 示 ， 将 information 通 


过 特殊 


7 太 人 


子 付 


串 “;， ，?” 分 隅 成 数组 对 该 字符 串 进 行 分 段 解 机 ， 将 解析 而 得 的 ID、 


text、name 及 X， ee 


代码 清单 3-18 ”WebElementCreator 中 的 


createWebElementAndSetLocation 


private WebElement createwebElementAndSetLocation(String information, WebView 


webView){ 
// 将 


ijnformation 通 过 特殊 字符 串 “ 


;1 “分隔 成 数组 
String[] data = information.split(";,"); 
String[] elements = null; 
int x = 0; 
int y = 


int width = 0; 
int height = 0; 


Hashtable<String, String> attributes = new Hashtable<String, String>(); 


try{ 
x = Math.round(Float .valueof(data[5])); 


y = Math.round(Float.valueof(data[6])); 
width = Math.round(Float.valueof(data[7])); 
height = Math.round(Float.valueof(data[8])); 
elements = data[9].split("\\#\\$"); 
}catch(Exception ignored){} 
if(elements != null) { 


for (int index = 0; index < elements.length; index++){ 
String[] element = elements[index].split(":: 


if (element.length > 1) { 
attributes.put(element[0], element[1]); 
} else { 
attributes.put(element[0], element[0]); 


} 
} 
} 
WebElement webElement = null,; 
try{ 
/ /设置 


WebElement 中 的 各 个 字段 


webElement = new WebElement(data[0], data[1], data[2], data[3], data[4], 
attributes); 
setLocation(webElement, webView, x, y, width, height); 
}catch(Exception ignored) 人 
return webElement; 


} 


这 样 ， 把 Js 执 行 时 提取 到 的 所 有 元 素 信 息 解析 出 来 ， 并 储存 至 
WebElement 对 象 中 ， 在 获取 到 相应 的 WebElement 对 象 后 ， 就 包括 了 元 
素 的 ID、text、className 等 属性 及 其 在 屏幕 中 的 坐标 ， 完 成 了 对 Web 目 
动 化 的 文 持 。 


3.3 Robotium 实 中 运用 


3.3.1 控件 ID 相同 时 获取 控件 


实际 界面 中 常常 有 一 些 子 控件 是 相同 ID 甚至 没有 ID 的 ， 但 这 时 候 
一 般 其 父 视图 是 有 ID 的 。 如 图 3-14 所 示 ， 每 个 TAB 的 控件 ID 是 相同 的 。 


A | 误 千 
发 现 榜 单 游戏 软件 娱乐 
图 3-14 ”拥有 相同 ID 的 底部 TAB 


因为 界面 中 也 很 可 能 会 出 现 多 个 发 现 、 游 戏 这 样 的 文本 ， 因 此 也 
不 能 采取 类 似 getText (“发 现 ”) 这 样 的 方式 。 这里， 我 们 就 可 以 通过 
ID 获取 唯一 父 控 件 ， 再 通过 过 滤 方 式 获 取 指 定 的 控件 。 


// 先 根据 


工 D 获 得 唯一 的 布局 
LinearLayout 

LinearLayout mTabs = (LinearLayout)solo.getView("main tabs"); 
/ /然后 通过 过 滤 方 式 获取 该 

LinearLayout 下 的 所 有 文本 控件 


ArrayList<TextView> tabs = solo 
.getCurrentViews(TextView.class,mTabs); 


如 果子 控件 的 ID 都 是 一 样 的 ， 而 我 们 仍然 希望 通过 ID 来 定位 控 
件 ， 那 么 应 该 如 何 获 取 呢 ? 我 们 知道 不 论 是 Activity 类 还 是 View 类 都 是 
可 以 通过 findViewById (intid) 方法 直接 在 控件 树 中 根据 ID 来 查找 控件 
的 ， 因 此 当 我 们 获得 一 个 父 视图 后 ， 就 可 以 通过 findViewByld (int id) 
方法 根据 ID 来 查找 相应 的 子 控件 ， 这 种 方法 可 以 普遍 应 用 在 ListView 
= 


// 先 根据 


工 D 获 得 唯一 的 布局 
ListView 
ListView mListView = (ListView)solo.getView("example list_ id"); 
// 先 通过 

mListView.getChildAt (0 ) 获 取 该 


ListView 的 第 一 个 


Child， 然 后 再 通过 该 


//Cchild 在 控件 树 中 使 


findViewById 根 据 


ID 来 获取 


TextView firstListTitle = (TextView) mListView.getCchildAt(0).findViewById(getId 
("example_title")); 


这 里 的 重点 是 findViewById (int id) 传 进去 的 是 int 型 的 ID， 而 我 
们 通过 hierarchyviewer 或 uiautomatorviewer 查 看 到 的 ID 都 是 String 型 的 ， 
由 前 文 的 原理 介绍 可 知 ， 我 们 可 以 将 String 型 的 古 转 换 成 int 型 的 D， 如 
代码 清单 3-19 所 示 : 


代码 清单 3-19 ”将 String 型 的 ID 转换 成 int 型 的 ID 


public int getId(String id,String packageName ){ 

Context targetContext = 
instrumentation.getTargetContext().getApplicationContext(); 

int viewId = targetContext.getResources().getIidentifier(id, "id", 
packageName ) ， 

LoguUtils,1ogD("CopyOfAssistantTabActivityTest"， "viewId:" + ViewId ) ， 

if(viewId == 0){ 

ViewId = targetContext.getResources().getIidentifier(id, "id", "android"); 


return viewId; 
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因此 ， 当 碰 到 同一 层级 控件 ID 相 同时 ， 可 以 先 寻 找 唯一 的 父 布 
局 ， 再 通过 父 布 局 寻找 子 控件 。 如 果子 控件 结构 均 相同 ， 那 么 可 以 通 
过 index 索 引 来 得 找 ， 如 果子 控件 结构 不 一 致 ， 则 可 以 通过 通 历 的 方式 
找到 指定 的 子 控件 。 


3.3.2” ListView 列表 遍历 


编写 Android 端 的 目 动 化 测 斌 用例， 最 和 常见 的 控件 有 ListView， 而 
要 想 测 试 ListView， 就 必然 要 涉及 ListView 的 遍历 。 


天 于 ListView 的 过 历 ， 可 能 首先 想到 的 十 类 似 如 代码 清单 3-20 的 实 
现 方式 。 


代码 清单 3-20 设想 中 的 列表 遍历 


for(int i=0;i<]listView,. getCount();i++){ 
listView.getchildAt(int index); 


但 是 ， 在 Android 中 ， 对 于 listView.getChildAt (int index) 而 言 ， 
如 果子 控件 是 在 屏幕 之 外 的 话 ， 那 么 是 无 法 点 击 的 ， 因 此 要 想 点 击 或 
测试 屏幕 之 外 的 子 控件 ， 束 需要 不 断 向 上 滑动 。 因 此 我 们 可 以 先 遍 历 
当前 屏幕 内 的 子 控 件 ， 然 后 翻 一 屏 ， 再 遇 历 屏幕 内 的 子 控件 ， 如 此 反 
复 就 可 以 遍历 ListView 所 有 的 子 控件 了 。 


对 于 ListView 而 言 ， 通 过 getFirstVisiblePosition () 和 
getLastVisiblePosition () 可 以 获取 ListView 在 屏幕 中 第 一 个 可 见 子 控 
件 及 最 后 一 个 可 见 子 控件 在 列表 中 的 位 置 。 当 遍历 至 当前 最 后 一 个 子 


控件 时 ， 通 过 solo.scrollListToLine (listView，lastPosition) 方法 将 列 
表 滑 至 lastPosition 所 在 的 位 置 ， 即 实现 翻 屏 的 效果 。 当 亿 历 至 每 个 
child 子 控件 时 ， 可 以 通过 该 子 控件 的 布局 结构 来 判断 该 子 控件 是 否 为 
要 查找 的 控件 。 男 外 ， 需 要 注意 的 是 ， 正 如 前 文 所 介绍 的 ， 
scrollListToLine (listView，lastPosition) 方法 并 不 会 直接 产生 上 滑 手 
势 ， 因 此 如 果 列 表 和 需要 产生 上 滑动 作 才 能 加 载 更 多 的 话 ， 则 还 需要 配 
合 使 用 drag 方 法 进行 上 拉 加 载 更 多 。 


如 代码 清单 3-21 所 示 ， 人 遍历 列 表 ， 查 找 列表 中 子 节 点 为 
RelativeLayout 且 子 节 点 的 标题 为 xxx 的 子 控件 。 


代码 清单 3-21 遍历 列表 并 找到 指定 标题 的 child 


public RelativeLayout findCardByType(int maxCount) { 
// 获取 当前 界面 中 的 


ListView 
ListView listView = getCurrentListView() ， 
int firstPosition 0; 
int lastPosition = 0; 
RelativeLayout relativeLayout = null; 
int currentPosition = 1; 
labelAll: 
for (int i = 0; i < length; i++) { 
firstPosition = listView.getFirstVisiblepPosition(); 
lastPosition = listView.getLastVisiblePosition(); 
for (int j = 1; j <= lastPosition - firstPosition; j++) { 
currentPosition++; 
If (currentPosition >= maxCount) { 
break labelAll; 


} 
// 判断 该 节点 是 否 为 


relativeLayout 
if (listView.getchildAt(j) instanceof RelativeLayout) { 
relativeLayout = (RelativeLayout) listView.getchildAt(j); 
// 这 里 可 以 对 该 


relativeLayount 进 行 判 断 ， 例 如 获取 该 


//relativeLayout 中 的 子 控件 ， 如 果 有 标题 则 判断 标题 等 


If (isSatisfied(relativeLayout)) { 
break labelAll; 
} 


relativeLayout = null; 
} 
} 
solo.scrollListToLine(listView, lastPosition); 


if (lastPosition >= listView.getCount()) { 
// 当 需 要 上 拉 加 载 更 多 时 ， 调 月 


drag 实 现 的 方法 进行 上 拉 加 载 更 多 


dragUpToShowAll(1istView); 
} 
sleeper.sleep(); 
} 
sleeper.sleep(); 
return relativeLayout 


3.3.3 ”修改 Robotium 以 支持 X5WebView 


本 贡 中 的 X5WebView 指 QQ 浏览 器 团队 出 品 的 腾讯 X5 内 核 中 的 
WebView。 除 了 QQ、 微 信 、 应 用 宝 等 众多 腾讯 内 部 产品 在 使 用 X5 内 核 
外 ， 京 东 、58 同 城 等 众多 腾讯 外 部 的 合作 伙伴 也 在 使 用 X5 内 核 。 


腾讯 X5 网 站 : http:/x5.tencent.com/。 


然而 Robotium 本 身 并 不 支持 获取 X5WebView 中 的 元 素 ， 因 此 无 法 
对 使 用 了 X5 内 核 的 Web 页 面 进 行 目 动 化 测试 ， 而 通过 3.2.2 节 中 介绍 的 
Robotium 文 持 WebView 原 理 可 知 ， 只 要 对 Robotium 稍 加 改造 ， 即 可 使 
用 同样 的 原理 获取 WebElement 对 象 ， 完 成 对 X5WebView 上 自动 化 的 文 
持 。 


这 里 再 概述 一 下 Robotium 支 持 WebView 的 过 程 ， 以 便 理 解 为 何 
Robotium 不 支持 X5 以 及 如 何 修 改 。 


步骤 1: 获取 目标 WebView 。 


如 代码 清单 3-13 所 示 ， 代 码 final WebView 
webView=viewFetcher.getFreshestView (viewFetcher.getCurrentViews 
(WebView.class) ) ; 调用 ViewFetcher 类 获取 当前 界面 中 的 
WebView， 而 该 WebView 是 android.webkit.WebView。 


步骤 2: 做 执行 JS 前 的 准备 工作 。 


如 代码 清单 3-13 所 示 ，final String 
javaScript=prepareForStartOfJavascriptExecution () ; 调用 
prepareForStartOfJavascriptExecution () ， 该 方法 还 调用 了 如 代码 清单 
3-22 所 示 的 代码 ， 将 WebSettings 是 否 允 许 执行 JS 设置 为 True (系统 默认 
是 False) 。 然 后 还 设置 了 WebView 的 WebChromeClient 

(WebChromeClient 用 于 辅助 WebView 处 理 Javascript 的 对 话 框 、 提 示 框 
等 ) 。 从 这 里 可 以 看 出 Robotium 使 用 的 是 继承 上 自 


android.webkit.WebChromeClient 风 RobotiumWebClient 。 
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RobotiumWebClient.enableJavascriptAndSetRobotiumWebClientd 


/和 
* Enables JavaScript in the given {Q@code WebViews} objects. 
大 


* @param webViews the {@code WebView} objects to enable JavaScript in 
*/ 


public void enableJavascriptAndSetRobotiumwebClient(List<WwebView> webViews, 
WebCchromeClient originalwebChromeClient){ 
this.originalWwebChromeClient = originalwebChromeClient; 
for(final WebView webView : webViews){ 
if(webView != null){ 
Inst,runonMainSync(new Runnable() { 
public void run() { 
//WebSettings 开 启 


JS 


webView.getSettings().setJavascriptEnabled(true); 
webView.setwebChromeClient(robotiumwebcClient); 


}); 


步骤 3: 在 指定 WebView 中 执行 相应 JS 。 


如 代码 清单 3-13 所 示 ， 最 后 调用 webView.loadUrl 
("javascript: "+javaScript+function) ; 方法 在 指定 的 WebView 中 执行 
相应 片段 的 JS 代 人 码 。 


从 以 上 核心 步骤 中 可 以 看 出 ，Robotium 不 文 持 X5 的 原因 在 于 ， 首 
先 ， 其 获取 目 孙 WebView 时 ， 有 是 获取 android.webkit,WebView 中 的 
WebView; 其 次 ， 辅 助 处 理 JS 的 WebChromeClient 也 是 继承 目 
android.webkit.WebChromeClient。 而 X5 内 核 中 的 WebView 并 不 是 继承 目 
android.webkit.WebView，X5 内 核 中 的 WebChromeClient 也 不 是 继承 目 
android.webkit.WebChromeClient， 因 此 Robotium 没 法 获取 X5 内 核 中 的 
目标 WebView， 也 就 没 法 在 目标 WebView 中 执行 JS 并 提取 WebElement 
元 素 。 了 解 个 中 绿 由 后 ， 束 可 以 稍 加 改造 以 文 持 X5WebView。 


如 图 3-15 所 示 为 以 外 部 引用 〈 即 该 jar 包 的 类 并 不 实际 打包 进 测试 
工程 ， 仅 在 IDE 调 试 时 用 。 当 调用 相应 的 类 时 ， 寻 找 的 是 被 测 工程 中 的 
相应 的 类 ) 的 方式 导入 X5 提 供 的 SDK。 


Java Build Path Dv 


bp 到 Android Dependencies 
b BM Android Private Libranes 


图 3-15 ”导入 X5 提 供 的 SDK 


在 获取 目标 WebView 时 ， 相 应 地 修改 成 X5 SDK 中 的 WebView。 如 
图 3-16 所 示 ， 获 取 目 标 WebView 时 修改 为 


com.tencent.smtt.sdk.WebView ° 


/** 
* Executes the given Javascript function 
a 
* @param function the function as a String 
* @return true if JavaScript function was executed 
了 


private boolean executeJavaScriptFunction(final String function){ 
final com.tencent.smtt.sdk.WebView webView = viewFetcher. 
getFreshestView(viewFetcher.getCurrentViews(com.tencent.smtt.sdk.WebView.class)); 


if(webView == null){ 
return false; 


final String javascript = prepareForStartOfJavascriptExecution(); 


activityUtils.getCurrentActivity(false).runOnUiThread(new Runnable() { 
public void run() { 
if(webView != null){ 
webView.loadUrl("javascript:" + javascript + function); 


} 
} 
DD); 


return true; 


图 3-16 ”修改 目标 WebView 


同样 地 ， 修 改 WebChromeClient 为 继承 目 
com.tencent.smtt.sdk.WebChromeClient 中 的 TxWebChromeClient， 然 后 在 
WebView 中 设置 WebChromeClient 时 使 用 TxWebChromeClient， 如 图 3-17 
所 示 。 


/说 
* Enables Javascript in the given {@code WebViews} objects. 


3 WebViews the {@code WebView} objects to enable JavaScript in 
0h 
public void enableJavascriptAndSetRobotiumWebClient(List<com.tencent.smtt.sdk.WebView> webViews, 
om.tencent .smtt .sdk.WebChromeClient originalWebChromeClient){ 

this.originalWebChromeClient = originalWebChromeClient; 
for(final com.tencent.smtt.sdk.WebView webView : webViews){ 

if(webView != null){ 

inst.runOonMainSync(new Runnable() { 
public void run() { 


webView.getSettings().setJevaScriptEnabled(true); 
webView.setWebChromeClient (robotiumWebClient); 


图 3-17 修改 目标 WebChromeClient 


对 于 其 他 有 相应 的 WebView 或 WebChromeClient 调 用 的 地 方 ， 均 修 
改 成 X5 SDK 中 对 应 的 WebView 及 WebChromeClient， 修 改 完成 后 ， 将 相 
应 的 类 市 上 前 级 以 便 区 分 ， 如 图 3-18 所 示 。 


LU 一 一 一 -3 一 -一 一-- 


》 [DN TxWebChromeClientjava 197 
》 [NN TeWebElementCreatorjava 892 
by [DN TxWebUtilsjava 1232 


图 3-18 ”修改 后 的 类 


当 需 要 获取 使 用 了 X5 内 核 的 Web 元 素 时 ， 调 用 TxWebUtils 类 中 的 
相应 方法 即 可 。 如 图 3-19 所 示 ， 与 Robotium 原 有 和 的 WebUtils 使 用 方法 一 
致 ， 至 此 ， 完 成 了 对 X5 内 核 的 支持 。 


4 位 TeWebUtils 1232 

日 < TxWebUtils(Config, Instrumentation, ActivityUtils, ViewFetcher Sleeper) 
旧 createAndReturnTextViewsFromWebElements(boolean) : ArrayList<TextView> 
© executeJavaScript(By, boolean) : boolean 

旧 executejJavaScrniptFunction(String) : boolean 

男 getCurrentWebChromeClient0 : TxWebChromeClient 

© getCurrentWebElementsQ : ArrayUst<WebElement> 

© getCurrentWebElements(By) : ArrayList<WebElement> 

© getCurrentWebViewContentHeigth0 : int 

© getCurrentWebViewContentWidth() : int 

上 ”getjavaScriptAsString0 : String 

四 getSufficentlyShownWebElements(boolean) : ArrayList<WebElement> 
© getTextViewsFromWebView0 : ArrayList<TextView> 

© getWebElements(boolean) : ArrayList<WebElement> 

© getWebElements(boolean, boolean) : ArrayList<WebElement> 

© getWebElements(By, boolean) ; ArrayList<WebElement> 

© | isWebElementSuffcientlyShown(WebElemenb : boolean 

别 prepareForStartOfjavascriptExecution() : String 

DD splitNameByUpperCase(String) : String 


图 3-19 ”TxWebUtils 中 的 类 方法 


3.4 本章 小 结 


本 章 分 三 小 让 ， 从 功能 、 原 理 及 实践 三 方面 介绍 了 Robotium 测 试 
框架 ， 第 一 小 节 先 全 面 概览 似 的 介绍 了 Robotium 的 整体 ， 然 后 从 控件 
获取 、 控件 操作 、WebView 文 持 、 上 断言 等 维度 介绍 了 相应 功能 及 其 使 
用 方法 ， 力 图 让 读者 知道 如 何 使 用 Robotium 测 试 框架 来 进行 用 例 编 
写 。 第 二 小 节 则 分 别 从 Native 和 Web 角 度 介 绍 了 Robotium 的 实现 原理 ， 
力图 让 读者 了 解 更 多 的 为 什么 ， 从 而 可 以 在 实际 项 目 中 更 灵活 地 使 用 
Robotium 编 写 测试 用 例 。 第 三 小 节 则 从 实践 运用 角度 选取 一 般 项 目 中 
常见 的 一 些 场景 ， 介 绍 使 用 Robotium 处 理 的 思路 与 方法 。 


本 章 主 要 从 测试 用 例 编写 过 程 这 一 思维 主线 来 介绍 Robotium 测 试 
框架 ， 从 中 也 可 以 看 出 ， 不 论 是 对 获取 复杂 控件 还 古 进 行 各 类 模拟 操 
作 ，Robotium 均 可 以 很 好 地 文 择 ， 且 也 可 以 文 持 App 中 的 Web 目 动 化 ， 
基本 可 以 满足 日 前 的 目 动 化 测试 需求 。 当 然 ，Robotium 也 有 如 回应 用 
能 力 弱 等 加 有 劣势 ， 实 际 上 也 并 没有 哪 一 款 测试 框 殿 可 以 解决 所 有 过 
到 的 测试 问题 ， 我 们 大 可 结合 不 同 的 测试 框架 、 测 试 工具 来 解决 实际 
项 目 中 的 问题 。 因 此 ，Robotium 可 以 说 是 一 款 不 可 多 得 的 优秀 的 目 动 
化 测试 框架 。 


第 4 曹 ”“Monkey 基 本 原理 及 扩展 应 用 


Monkey 是 Android 系 统 目 市 的 一 款 稳 定性 测试 小 工具 ， 它 以 简单 易 
用 、 方 便 快 捷 而 广 受 测试 者 欢迎 。 本 章 分 为 四 部 分 ， 由 浅 入 深 地 为 读 
者 详细 介绍 Monkey 工 具 。 第 一 部 分 介绍 Monkey 基 础 知识 ， 包 括 
Monkey 概 况 、 常 用 参数 、11 大 事件 、 环 境 搭 建 ， 以 及 Monkey 命 令 行 使 
用 方法 ; 第 二 部 分 介绍 Monkey 测 试 的 基本 方法 ， 包 括 常 规 的 稳定 性 测 
试 、 目 定义 脚本 的 稳定 性 测试 、 结 合 常 用 辅助 命令 的 Monkey 测 试 ， 以 
及 Monkey 日 志 的 分 析 方 法 ; 第 三 部 分 介绍 Monkey 的 原理 ， 包 括 代码 框 
染 和 代码 逻辑 分 析 ， 第 四 部 分 是 Monkey 使 用 的 进 阶 篇 ， 通 过 截图 改造 
和 Wi-Fi 监 控 改 造 两 个 实际 案例 ， 介 绍 了 如 何 通过 修改 Monkey 源 码 达 到 
优化 Monkey 工 具 的 目的 。 本 章 结构 知识 图 如 图 4-1 所 示 。 


Monkey 简介 
Monkey 参数 介绍 
基础 知识 二 Monkey 事件 介绍 Monkey 的 基础 知识 和 工具 特点 介绍 
Monkey 环境 搭建 介绍 
Monkey 启动 介绍 
常规 的 稳定 性 测试 
Monkey 测试 实 叶 自 定 义 脚本 的 稳定 性 测试 RS 
测试 法 结合 辅助 命令 的 Monkey 测试 |Monkey 实战 案例 讲解 
Monkey 日 志 分 析 -Monkey 测试 结果 分 析 方 法 
L 木 大班 _TMonkey 代码 框架 介绍 
基本 原理 Monkey 代码 逻辑 详解 


Monkey 代码 重 编译 执行 方法 
扩展 应 用 示 pene 截图 优化 通过 代码 改造 解决 实践 中 问题 


Monkey 基本 原理 及 扩展 应 用 
Pyronkey 代码 逻辑 讲解 ， 加 深 理解 


Monkey Wi-Fi 自动 重 连 优化 的 案例 介绍 
Monkey 扩展 应 用 的 优点 和 缺点 


图 4-1 ”本章 知识 结构 图 


接 下 来 ， 让 我 们 开始 来 学 习 吧 。 


4.1 _ Monkey 基础 知识 


4.1.1 _ Monkey 概况 


在 Android 的 官方 目 动 化 测试 领域 有 一 只 非常 著名 的 “猴子 ? 叫 
Monkey， 这 只 “猴子” 一旦 启动 ， 束 会 让 被 测 的 Android 应 用 程序 像 猴 
子 一 样 活 蹦 乱 跳 ， 到 处 乱 跑 。 人 们 第 用 这 只 “猴子 "来 对 被 测 程序 进行 
压力 测试 ， 检 查 和 评估 被 测 程序 的 稳定 性 。 


Android 官 方 对 这 只 “猴子 ”的 描述 是 这 样 的 : Monkey 是 Google 近 供 
的 一 个 命令 行 工 具 ， 可 运行 在 模拟 右 或 实际 设备 中 。 它 同系 统 发 送 伪 
随机 的 用 户 事 件 ， 模 拟 用 户 的 按键 输入 、 触 措 屏 输入 、 手 势 答 入 等 ， 
从 而 对 正在 运行 的 应 用 程序 进行 压力 测试 ， 目 的 是 看 设备 多 长 时 间 会 
出 现 异 常 ， 并 观察 系统 的 稳定 性 和 容错 性 能 。 


Monkey 程 序 是 Android 系 统 目 市 的 ， 其 启动 脚 本 是 位 于 Android 系 
统 的 /system/bin 目 录 的 Monkey 文 件 ， 其 jar 包 是 位 于 Android 系 统 
的 /system/framework 目 录 的 Monkey.jar 文 件 。 用 户主 要 是 通过 adb 命 令 
来 启动 Monkey 的 ，Monkey 在 运行 时 ， 会 根据 命令 行 参数 的 配置 ， 生 
成 伪 随 机 的 事件 流 ， 并 在 Android 设 备 上 执行 对 应 的 测试 事件 。 同 时 ， 


Monkey 还 会 对 测试 系统 进行 监测 ， 当 出 现 以 下 三 种 情况 时 会 进行 特殊 
处 理 : 


:如 限定 了 Monkey 运 行 在 特定 包 上 ， 当 监测 到 试图 转 到 其 他 包 的 
操作 ， 将 对 其 进行 阻止 。 


如 应 用 程序 骨 溃 或 接收 到 任何 失控 异常 ，Monkey 将 记录 对 应 的 
错误 日 志 ， 并 根据 命令 行 参数 判断 是 停止 运行 还 是 继续 运行 。 


-如果 应 用 程序 发 生 了 程序 无 响应 (application not responding) 的 
错误 ，Monkey 将 记录 对 应 的 错误 日 志 ， 并 根据 命令 行 参数 判断 是 停止 


运行 还 是 继续 运行 。 


按照 选 定 的 不 同 级 别 的 反馈 信息 ， 在 Monkey 中 还 可 以 看 到 其 执行 
过 程 报 告 和 生成 的 事件 。 


4.1.2 Monkey 参数 


Monkey 启 动 的 命令 行 脚本 为 : 


monkey [options] <count> 


其 中 ，options 表 示 Monkey 执 行 的 可 配置 参数 ， 是 可 选项 (如 果 不 
指定 options，Monkey 将 以 无 反馈 模式 启动 ， 并 把 事件 任意 发 送 到 安装 


在 目标 环境 中 的 全 部 包 ) ; count 表 示 Monkey 执 行 的 事件 数 ， 为 必 选 
项 。 


Options 可 简单 划分 为 五 类 : 
基本 配置 类 参数 。 
事件 类 型 和 频率 参数 。 
约束 限制 类 参数 。 
调试 类 参数 。 
-官方 隐 减 类 参数 。 


以 下 是 针对 以 上 五 种 类 型 参数 的 详细 介绍 。 


1. 基 本 配置 类 参数 


Monkey 的 基本 配置 类 参数 包括 帮助 参数 和 日 志 信 息 参 数 。 帮 助 参 
数 用 于 输出 Monkey 命 令 使 用 指导 ; 日 志 信息 参数 将 日 志 分 为 三 个 级 
别 ， 级 别 越 高 ， 日 志 的 信息 越 详细 。 具 体 参 数 信息 见 表 4-1。 


表 4-1 Monkey 基 本 配置 类 参数 表 


参数 说 明 
--help 输出 Monkey 的 命令 行使 用 方法 
表示 反馈 信息 的 级 别 ，Monkey 命令 行 中 每 增加 一 个 -v 参数 ，Monkey 日 志 反 馈 信 息 的 级 别 会 对 应 
增加 一 个 Level。Level 0 ( 缺 省 值 ) 除 启 动 提示 、 测 试 完成 和 最 终结 果 之 外 ， 提 供 较 少 信息 。Level 1 
-V (-v-v) 提供 较为 详细 的 测试 信息 ， 如 逐个 发 送 到 Activity 的 事件 。Level 2 ( -v-v-v) 提供 更 加 详细 的 设 


置信 息 ， 如 测试 中 被 选中 的 或 未 被 选中 的 Activity 等 
举例 : adb shell monkey -v-v 10 


2. 事 件 类 型 和 频率 参数 


Monkey 的 事件 类 参数 的 作用 是 对 随机 事件 进行 调控 ， 从 而 使 其 遵 
照 设 定 运行 ， 如 设置 各 种 事件 的 百分比 、 设 置 事 件 生 成 所 使 用 的 种 子 
值 等 。 频 率 参 数 主要 限制 事件 执行 的 时 间 间 隔 。 这 两 类 的 详细 参数 介 
绍 见 表 4-2。 


3. 约 束 限 制 类 参数 


We cnn 支行 的 范围 限制 在 
一 个 或 多 个 包 或 关中。 详细 参数 介绍 见 表 4-3 。 


表 4-2 ” Monkey 事件 类 型 和 频率 参数 表 


3 
渗 


-s <=seed> 


--throttle = 毫秒 数 > 


--pct-touch = 百分比 > 


--pct-motion = 百分比 > 
--pct-pinchzoom = 百分比 > 
--pct-trackball = 百分比 > 
--pct-rotation <= 百分比 > 


--pct-nav < 百分比 > 


--pct-majomav< 上 百分比 = 


--pct-syskeys 二 百分比 = 


--pct-appswitch = 百分比 > 


--pct-flip < 百分比 > 


--pct-anyevent 二 百分比 = 


说 明 

伪 随 机 数 生成 器 的 种 子 值 。 如 果 用 相同 的 种 子 值 再 次 运行 Monkey， 它 将 生成 
相同 的 事件 序列 

举例 adb shell monkey -sll11-v10 

在 事件 之 间 搬 入 固定 延迟 。 通 过 这 个 选项 可 以 减缓 Monkey 的 执行 速度 。 如 果 
不 指定 该 选项 ，Monkey 将 不 会 被 延迟 ， 事 件 将 尽 可 能 快 地 被 生成 

调整 触摸 事件 的 百分比 (触摸 事件 是 一 个 down-up 事件 ， 它 发 生 在 屏幕 上 的 某 
单一 位 置 ) 

调整 动作 事件 的 百分比 (动作 事件 由 屏幕 上 某 处 的 一 个 down 事件 、 
伪 随 机 事件 和 一 个 up 事件 组 成 ) 

调整 二 指 缩放 事件 的 百分比 (二 指 缩放 事件 即 智能 机 上 的 放大 缩小 手势 操作 ) 

调整 轨迹 事件 的 百分比 (轨迹 事件 由 一 个 或 几 个 随机 的 移动 组 成 ， 有 时 还 伴随 
点 击 ) 

调整 屏幕 旋转 事件 的 百分比 ( 横 屏 和 竖 屏 ) 

调整 “基本 ”导航 事件 的 百分比 (导航 事件 由 来 自 方向 输入 设备 的 up、down、 
left、right 组 成 ) 

调整 “主要 ”导航 事件 的 百分比 (这 些 导航 事件 通常 引发 图 形 界面 中 的 动作 ， 
如 5-way 键盘 的 中 间 按 键 、 回 退 按键 、 菜 单 按键 ) 

调整 “系统 ”按键 事件 的 百分比 (这些 按键 通常 被 保留 ， 由 系统 使 用 ， 如 
Home 、Back、Start Call、End Call 及 音量 控制 键 ) 

调整 启动 Activity 的 百分比 (在 随机 间隔 里 ，Monkey 通过 调用 startActivity 方 
法 最 大 限度 地 开启 该 package 下 的 全 部 Activity 的 一 种 方法 ) 

调整 键盘 事件 的 百分比 (键盘 事件 如 点 击 输入 框 、 键 盘 弹 起 、 点 击 输入 框 以 外 
区 域 、 键 盘 收 回 等 ) 

调整 其 他 类 型 事件 的 百分比 (包罗 了 所 有 其 他 类 型 的 事件 ， 如 按键 、 其 他 不 常 
用 的 设备 按钮 等 ) 


-系列 的 


表 4-3 Monkey 约束 限制 类 参数 表 


说 明 


如 果 用 此 参数 指定 了 一 个 或 几 个 包 ，Monkey 将 只 允许 系统 启动 这 些 包 里 的 Activity。 如 果 应 


用 程序 还 需要 访问 其 他 包 里 的 Activity (如 选择 一 个 联系 人 )， 那 些 包 也 需要 在 此 同时 指定 。 如 
果 不 指 定 任何 包 ，Monkey 将 允许 系统 启动 全 部 包 里 的 Activity。 要 指定 多 个 包 ， 需 要 使 用 多 


个 -p 选 项 ， 每 个 -p 选项 只 能 用 于 一 个 包 
如 果 用 此 参数 指定 了 一 个 或 几 个 类 别 ( Category)，Monkey 将 只 允许 系统 启动 被 这 些 类 别 中 


-Cc 三 类 别名 > 


的 某 个 类 别 列 出 的 Activity。 如 果 不 指定 任何 类 别 ，Monkey 将 选择 下 列 类 别 中 列 出 的 Activity: 
IntentCATEGORY _ LAUNCHER 或 ntentCATEGORY MONKEY。 要 指定 多 个 类 别 ， 需 要 使 


用 多 个 -c 选项 ， 每 个 -c 选项 只 能 用 于 一 个 类 别 


4. 调 试 类 参数 


通过 调试 类 命令 ， 可 以 对 Monkey 进 行 一 些 简 单 的 调试 ， 可 以 快速 
定位 Monkey 执 行 过 程 中 的 一 些 问 题 。 如 果 用 户 想 监控 应 用 程序 所 调用 
的 包 之 间 的 转换 ， 则 可 以 用 --dbg-no-events 参 数 ; 如 果 用 户 想 监控 内 存 
泄漏 ， 可 以 用 --hprof 参 数 。 详 细 参 数 介 绍 见 表 4-4。 


表 4-4 Monkey 调试 类 参数 表 


参数 说 明 


设置 此 选项 ，Monkey 将 执行 初始 启动 ， 进 入 一 个 测试 Activity， 不 会 再 进 一 
步 生成 事件 。 为 了 得 到 最 佳 结果 ， 把 它 与 -v、 一 个 或 几 个 包 约 束 ， 以 及 一 个 保持 
Monkey 运行 30 秒 或 更 长 时 间 的 非 零 值 联合 起 来 ， 从 而 提供 一 个 可 以 监视 应 用 程 
序 所 调用 的 包 之 间 的 转换 的 环境 


--dbg-no-events 


设置 此 选项 ， 将 在 Monkey 事件 执行 之 前 和 执行 之 后 生成 内 存 快 照 文 件 存 放 于 
--hprof 手机 的 data/misc 目录 。 通 过 对 比 执 行 前 后 的 内 存 快照 文件 ， 可 以 协助 定位 内 存 泄 
漏 问 题 。 由 于 内 存 快 照 文 件 比 较 大 ， 所 以 要 小 心 使 用 


通常 ， 当 应 用 程序 前 溃 或 发 生 任何 失控 异常 时 ，Monkey 将 停止 运行 。 如 果 设 


--ignore-crashes ee ED se 
一 置 此 选项 ，Monkey 将 继续 向 系统 发 送 事件 ， 直 到 计数 完成 


通常 ， 当 应 用 程序 发 生 任 何 超时 错误 (如 出 现 “Application Not Responding” 
--ignore-timeouts 对 话 框 ) 时 ，Monkey 将 停止 运行 。 如 果 设 置 了 此 选项 ，Monkey 将 继续 向 系统 发 
送 事 件 ， 直 到 计数 完成 


通常 ， 当 应 用 程序 发 生 许可 错误 (如 启动 一 个 需要 某 些许 可 的 Activity)， 
nN. os 


--ignore-security-exceptions “| Monkey 将 停止 运行 。 如 果 设 置 了 此 选项 ，Monkey 将 继续 癌 系 统 发 送 事件 ， 直 到 


计数 完成 


通常 ， 当 Monkey 由 于 一 个 错误 而 停止 时 ， 出 错 的 应 用 程序 将 继续 处 于 运行 状 
--kill-process-after-error 


态 。 当 设置 了 此 选项 时 ， 将 会 通知 系统 停止 发 生 错误 的 进程 
牛 


--monitor-native-crashes 监视 并 报告 Android 系统 中 本 地 代码 的 前 溃 事 人 


--wait-dbg 停止 执行 中 的 Monkey， 直 到 有 调试 各 和 它 相 连接 


5. 官 方 隐藏 类 参数 


党 


在 Android 官 网 上 还 有 三 个 参数 是 看 不 到 说 明 的 ， 即 为 隐藏 
这 三 个 参数 的 详细 介绍 见 表 4-5。 


类 
Ei 


\ 


表 4-5 ”Monkey 官 方 隐藏 类 参数 表 


--pkg-blacklist-fle < 黑 
名 单 文件 > 


--pkg-whitelist-file < 白 
名 单 文件 > 


说 明 

限制 Monkey 不 测试 于 指定 黑 名 单 文档 中 记录 的 包 (Package)。 若 没有 使 用 这 个 参数 ， 
Monkey 会 测试 系统 内 所 有 的 包 。 若 使 用 了 该 参数 ， 可 通过 在 黑 名 单 文档 内 记录 所 有 不 
要 测试 的 包 名 称 ,， 来 限制 Monkey 的 执行 范围 。 黑 名 单 文档 中 每 一 行 只 能 放 一 个 包 名 

限制 Monkey 只 测试 于 指定 的 白 名 单 文档 中 记录 的 包 ( Package)。 若 没有 使 用 这 个 参 
数 ，Monkey 会 测试 系统 内 所 有 的 包 。 若 使 用 了 该 参数 ， 可 通过 在 白 名 单 文档 内 记录 所 
有 要 测试 的 包 名 ， 来 限制 Monkey 的 执行 方位 。 白 名 单 文档 中 每 一 行 只 能 放 一 个 包 名 

注意 : 若 要 测试 的 包 与 其 他 的 包 有 关联 ， 则 必须 一 起 指定 这 些 包 来 执行 这 项 参数 


< 脚本 文件 > 


指定 Monkey 执行 用 户 自 定义 的 脚本 文件 
(在 4.2.1 节 中 会 介绍 改 参数 的 详细 使 用 方法 ) 


4.1.3 Monkey 事 件 


Monkey 所 执行 的 随机 事件 流 中 包 侣 11 大 事件 ， 分 别 是 触摸 事件 、 
手势 事件 、 二 指 缩放 事件 、 轨 迹 事件 、 屏 幕 旋转 事件 、 基 本 导航 事 
件 、 主 要 导航 事件 、 系 统 按 链 事 件 、 局 动 Activity 事 件 、 键 副 事 件 、 其 
他 类 型 事件 。Monkey 通 过 这 11 大 事件 来 模拟 用 户 的 常规 操作 ， 对 手机 
App 进 行 稳定 性 测试 。 下 面 让 我 们 来 详细 了 解 这 11 大 事件 。 


1. 触 摸 事件 


触 措 事件 是 指 在 屏幕 某 处 按 下 并 抬 起 的 操作 ， 可 通过 --pctrtouch 参 
数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 的 日 志 可 以 看 
到 : 


:Sending Touch (ACTION_DOWN): 0,(444.0,1716.0 
:Sending Touch (ACTION_UP): 9,(447.18365,1728, 0087 ) 


该 事件 由 一 组 Touch (ACTION_DOWN) 和 Touch 
(ACTION_UP) 事件 组 成 ， 在 手机 上 看 到 实际 操作 类 似 于 点 击 。 


2. 手 势 事 件 


手势 事件 是 指 在 屏幕 某 处 的 按 下 、 随 机 移动 、 抬 起 的 操作 ， 即 直 
线 滑动 操作 。 可 通过 --pct-motion 参 数 来 配置 其 事件 百分比 。 从 Monkey 
执行 该 事件 对 外 输出 的 日 志 可 以 看 到 ; 


:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 


Touch 
Touch 
Touch 
Touch 
Touch 
Touch 


(ACTION_DOWN): 
(ACTION_MOVE): 
(ACTION_MOVE): 
(ACTION_MOVE): 
和 
(ACTION_UP): 0 


: (282.0,750.0) 

: (281.0507,745.5253) 

: (274.9443,743.3276) 

: (269.18774,738.50525) 

: (260.14917,733.6212) 
254.1414,730.6132) 


ooo0oe 


该 事件 是 由 一 个 ACTION_DOWN 事 件 、 一 系列 ACTION_MOVE 
事件 和 一 个 ACTION_UP 事 件 组 成 的 ， 在 手机 上 看 到 的 实际 操作 是 一 
个 没有 拐弯 的 直线 滑动 操作 。 


3. 二 指 缩放 事件 


二 指 缩放 事件 是 指 在 屏幕 上 的 两 处 同时 按 下 ， 并 同时 移动 ， 最 后 
同时 拾 起 的 操作 ， 即 帝 能 机 上 的 放大 缩小 手势 操作 。 可 通过 --pct- 
pinchzoom 参 数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 
的 日 志 可 以 看 到 : 


:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 


Touch 
Touch 
Touch 
Touch 
Touch 
Touch 
Touch 


(ACTION_DOWN): 0:(274.0,193.0) 

(ACTION_POINTER DOWN 1): 0:(272.80875,198.17978) 1:(26.0,312.0) 
(ACTION_MOVE): 0:(251.31396,198.5104) 1:(24.973522, 308.64676) 
(ACTION_MOVE): 0:(240.28494,202.44012) 1:(23.442032,307.8576) 
(ACTION_MOVE): 0:(221.90855,206.75597) 1:(22.903313,306.47507) 
(ACTION_MOVE): 0:(210.28592,212.24286) 1:(17.78174,303.11304) 
(ACTION_POINTER_UP 1): 0:(171.06334,236.1724) 1: 


(10.3147135, 293.79877) 
:Sending Touch (ACTION_UP): 0:(161.06638,240.22447) 


该 事件 起 始 是 一 个 ACTION_DOWN 事 件 和 一 个 
ACTION_POINTER_DOWN 事 件 ， 即 模拟 两 个 手指 同时 点 下 ， 中 间 是 
一 系列 的 ACTION_MOVE 事 件 ， 即 两 个 手指 同时 在 屏幕 上 直线 请 动 ; 
结束 是 由 一 个 ACTION_POINTER_UP 事 件 和 一 个 ACTION_UP 事 件 组 
成 的 ， 即 两 个 手指 同时 放 开 。 


4. 轴 迹 事件 


轨迹 事件 古 由 一 个 或 多 个 随机 的 移动 组 成 的 ， 有 时 会 伴随 着 点 
击 。 很 早 之 前 的 Android 手 机 市 有 轨迹 球 ， 这 个 事件 束 是 模拟 的 轨迹 球 
的 操作 。 现 在 的 手机 几乎 都 没有 轨迹 球 ， 但 轨迹 球 事件 中 包含 曲线 滑 
动 操 作 ， 如 果 被 测 程序 需要 曲线 滑动 时 可 以 选用 此 参数 。 可 通过 --pct- 
trackball 参 数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 的 
日 志 可 以 看 到 : 


:Sending Trackbal1 (ACTION_MOVE): 0:(2.0,3.0) 
:Sending Trackball (ACTION_MOVE): 0:(-1.0,4.0) 
:Sending Trackball (ACTION_ MOVE): 0:(2.0,-3.0) 


该 事件 是 由 一 系列 的 Trackball (ACTION_MOVE) 事件 组 成 的 ， 
观察 手机 上 的 操作 ， 即 为 一 系列 的 曲线 湛 动 操 作 。 


5. 屏 幕 旋转 事件 


屏幕 旋转 事件 是 一 个 隐藏 事件 ， 在 Android 官 方 文档 中 并 没有 记 孙 
这 个 事件 。 它 其 实 是 模拟 的 Android 手 机 的 横 屏 和 竖 屏 切换 。 可 通过 -- 
pct-rotation 参 数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 
的 日 志 可 以 看 到 : 


:Sending rotation degree=1, persist=false 
:Sending rotation degree=3, persist=true 
:Sending rotation degree=2, persist=true 
:Sending rotation degree=0, persist=true 


该 事件 由 一 个 rotation 事 件 组 成 ， 其 中 degree 表 示 的 是 旋转 方 癌 ， 
顺 时 针 旋 转 ，0 表 示 旋 转 90 度 的 方向 ，1 表 示 旋 转 180 度 的 方向 ，2 表 示 
旋转 270 度 的 方向 ，3 表 示 旋 转 360 度 的 方向 。 在 执行 过 程 中 ， 可 以 看 到 
手机 屏幕 在 横竖 屏 之 间 不 断 地 切换 。 


6. 基 本 导航 事件 


基本 导航 事件 是 指点 击 方向 输入 设备 的 上 上、 下、 无 、 右 按键 的 操 
作 ， 现 在 手机 上 很 少 有 上 、 下 、 左 、 右 按键 ， 这 种 事件 一 般 用 得 比较 
少 。 可 通过 --pct-nav 参 数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 
对 外 输出 的 日 志 可 以 看 到 : 


:Sending Key (ACTION_DOWN): 19 // KEYCODE_DPAD_UP 
:Sending Key (ACTION_UP): 19 // KEYCODE_DPAD_UP 


:Sending Key (ACTION_DOWN): 20 // KEYCODE_DPAD_DOWN 
:Sending Key (ACTION_UP): 20 // KEYCODE_DPAD_DOWN 
:Sending Key (ACTION_UP): 21 // KEYCODE_DPAD_LEFT 


:Sending Key (ACTION_DOWN) : 22 // KEYCODE_DPAD_RIGHT 


:Sending Key (ACTION_DOWN): 21 // KEYCODE_DPAD_LEFT 
:Sending Key (ACTION_UP): 22 // KEYCODE_DPAD_RIGHT 


该 事件 是 由 一 个 Key (ACTION_DOWN) 和 一 个 Key 
(ACTION_UP) 组 成 的 ， 点 击 的 就 是 上 、 下 、 左 、 右 四 个 方 同 按 
键 。 


人 


主要 导航 事件 是 指点 击 “ 主 要 导航 "按键 的 操作 ， 这 些 按键 通 肖 会 
导致 UI 界 面 中 的 动作 ， 如 5-way 键 盘 的 中 间 键 、 回 退 按键 、 沫 单 按 
键 。 可 通过 --pct-majornav 参 数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 
事件 对 外 输出 的 日 志 可 以 看 到 : 


:Sending Key (ACTION_DOWN): 23 // KEYCODE_DPAD_CENTER 


:Sending Key (ACTION_UP): 23 // KEYCODE_DPAD_CENTER 
:Sending Key (ACTION_DOWN): 82 // KEYCODE_MENU 
:Sending Key (ACTION_UP): 82 // KEYCODE_MENU 


该 事件 是 由 一 个 Key (ACTION_DOWN) 和 一 个 Key 
(ACTION_UP) 组 成 的 ， 点 击 的 按键 束 是 中 间 键 和 羔 单 链 。 


8. 系 统 按键 事件 


系统 按键 事件 是 指点 击 系统 保留 使 用 的 按键 的 操作 ， 如 点 击 Home 
键 、 返 回 键 、 音 量 调和 键 等 。 可 通过 --pctrsyskeys 人 参数 来 配置 其 事件 百 
分 比 。 从 Monkey 执 行 该 事件 对 外 输出 的 日 志 可 以 看 到 : 


:Sending Key (ACTION_DOWN): 5 // KEYCODE_CALL 
:Sending Key (ACTION_UP): 5 // KEYCODE_CALL 


:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 
:Sending 


Key 
Key 
Key 
Key 
Key 
Key 
Key 
Key 


(ACTION_DOWN): 4 
(ACTION_UP): 4 
(ACTION_DOWN): 3 
(ACTION_UP): 3 
DOWN): 24 
(ACTION_UP): 24 
(ACTION_DOWN): 25 
(ACTION_UP): 25 


(ACTION 


KEYCODE_BACK 
KEYCODE_BACK 
KEYCODE_HOME 
KEYCODE_HOME 
KEYCODE_VOLUME_UP 
KEYCODE_VOLUME_UP 
KEYCODE_VOLUME_DOWN 
KEYCODE_VOLUME_DOWN 


该 事件 是 由 一 个 Key (ACTION_DOWN) 和 一 个 Key 


(ACTION_UP) 组 成 的 ， 


9. 启 动 Activity 事 件 


点 击 的 束 是 上 面 说 到 的 几 个 系统 按键 。 


局 动 Activity 事 件 是 指 在 手机 上 局 动 一 个 Activity 的 操作 。 在 随机 
的 时 间 间 隔 中 ， MO () 方法 ， 作 为 最 大 限 
中 全 部 Activity 的 一 种 方法 。 可 通过 --pct-appswitch 参 
数 来 配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 的 日 志 可 以 看 


度 上 禾 盖 被 测 包 


到 : 


:Switch: #Intent;action=android.intent,.action.MAIN;category=android.intent. 
category .LAUNCHER; lJaunchFlags=0x10200000;component=com.android,.settings/. 


Settings,; 


end 


// Allowing start of Intent { act=android,.intent.action.MAIN cat=[android. 
intent.category.LAUNCHER] cmp=com.android,.settings/.Settings } in package com. 
android.settings 


该 事件 是 由 一 个 Switch 操作 组 成 的 ， 从 手机 上 看 ， 上 面 的 操作 实 


际 是 打开 了 com.android.settings 这 


这 个 应 用 的 一 个 


com.android.settings.Settings 的 Activity 界 面 。 


10. 键 副 事 件 


键盘 事件 主要 是 一 些 与 键 副 相关 的 操作 。 比 如 点 击 输入 框 、 键 盘 
弹 起 、 点 击 输入 框 以 外 区 域 、 键 副 收 回 等 。 可 通过 --pct-flip 参 数 来 配 
置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 的 日 志 可 以 看 到 : 


:Sending Flip keyboardopen=false 
:Sending Flip keyboardopen=true 


如 日 志 所 示 ， 这 里 主要 是 键盘 的 打开 和 关闭 操作 。 


11. 其 他 类 型 事件 


其 他 类 型 事件 包括 了 除 前 面 提 到 的 10 种 事件 外 其 他 所 有 的 事件 ， 
如 按键 、 其 他 不 第 用 的 设备 上 的 按钮 等 。 可 通过 --pct-anyevent 参 数 来 
配置 其 事件 百分比 。 从 Monkey 执 行 该 事件 对 外 输出 的 日 志 可 以 看 到 : 


:Sending Key (ACTION_ DOWN): 59 // KEYCODE_SHIFT_LEFT 
:Sending Key (ACTION_UP): 59 // KEYCODE_SHIFT_LEFT 
:Sending Key (ACTION_DOWN): 138 // KEYCODE_F8 
:Sending Key (ACTION_UP): 138 // KEYCODE_F8 
:Sending Key (ACTION_DOWN): 45 // KEYCODE_Q 

:Sending Key (ACTION_UP): 45 // KEYCODE AQ 

:Sending Key (ACTION_DOWN ) : 192 // KEYCODE_BUTTON_5 
:Sending Key (ACTION_UP): 192 // KEYCODE_BUTTON_5.. 


该 事件 是 由 一 个 Key (ACTION_DOWN) 和 一 个 Key 
(ACTION_UP) 组 成 的 ， 点 击 的 按键 就 是 其 他 的 一 些 系统 按键 ， 如 
字母 按键 、 数 字 按 键 等 。 因 为 现在 手机 很 少 带 字 母 按键 或 数字 按键 ， 
所 以 这 个 事件 一 般 使 用 得 比较 少 。 


4.1.4 Monkey 环境 搭建 
了 解 了 Monkey 的 参数 及 11 大 事件 后 ， 接 下 来 让 我 们 了 解 一 下 
Monkey 的 运行 环境 搭建 方法 。 
Monkey 是 由 adb 命 令 来 启动 的 ， 故 只 要 配置 好 adb 环 境 即 可 。 
(1) 下 载 并 安装 Android SDK 和 JDK 。 


(2) 将 Android SDK 目 录 下 的 platform-tools 和 tools 目 录 配 置 到 系统 


环境 变量 Path 中 。 


(3) 打开 cmd 命 令 行 窗口 ， 输 入 “adb”， 能 显示 adb 帮 助 信息 ， 如 
图 4-2 所 示 ， 则 Monkey 环 境 配 置 成 功 。 


页 Em: Cindowssystamancmnd,ene 


INicrosoft Windows [版 本 6.1.7600] - 
版 权 所 有 {c) 2009 Microsoft Corporation。 和 保留 所 有 权利 。 


c 


:\Users\sharonzheng>Yadb 


Android Debug Bridge version 1, 


-a 
-qd 


| = 下 


-5s <specific device> 


| -p <product name or path> 


“=H 
-P 
devices [~1] 


connect <host>[:<port>] 


| disconnect 【<host>[:<port>]] 


6， 


31 


directs 
directs 
returns 
directs 
returns 
directs 


adb to listen on all interfaces for a connection 
command to the only connected USE device 

an error if more than one USB deuice is present. 
command to the only running emulator. 

an error if more than one emulator is running. 
command to the device or emulator with the 9iuen 


serial number or qualifier. OQverrides ANDROID_SERIAL 
enuironment variable. 

simple product name like “sooner ，or 

a relative/absolute path to a product 

out directory like ‘out/target/product/sooner'. 

If -p is not specified, the ANDROID_PRODUCT_OUT 
enuironment variable is used, which must 

be an absolute path. 


Name of 
Port of 


adb seruer host (default: localhost) 
adb seruer (default: S5837) 


list all connected deuices 
( -1”will also list device qualifiers) 


connect 


Port 5555 is Used by default if no port number is specified 


to a device uia TCP/IP 


disconnect from a TCP/IP device. 


Port S5555 is Used by default if no port number is specified 


Using this command with no additional arguhents 


图 4-2 ” ”Monkey 环境 配置 成 功 


[| 区 到 


相 


下 


4.1.5“ “Monkey 启动 


Monkey 局 动 方式 很 商 单 : 移 连 接 被 测 手机 到 PC 上 ， 人 然后 打开 CMD 
命令 行 窗口 输入 对 应 的 adb 命 令 行 即 可 。 通 过 命令 行 局 动 Monkey 有 了 两 种 
pa 


.直接 PC 启动 
> adb shell monkey [options] <count> 
Shell 端 启动 


>adb shell 
>monkey [options] <count> 


这 两 者 的 区 别 是 ， 通 过 PC 端 局 动 ，Monkey 运 行 日 志 可 以 保存 在 PC 
上 ; 通过 Shell 端 启动 ，Monkey 运 行 日 志 可 以 保存 在 手机 里 (保存 结果 
的 命令 在 4.2.2 节 会 详细 介绍 ) 。 


注音 ”Monkey 启 动 后 会 不 断 地 向 被 测 对 象 发 送 随机 事件 流 ， 
直到 事件 执行 完毕 或 者 发 生 异常 时 才 停止 。 在 Monkey 运 行 过 程 中 ， 即 
便 断 开 与 PC 的 连接 ，Monkey 依 然 可 以 在 手机 上 继续 运行 。 


停止 Monkey 的 方法 是 : 直接 杀 掉 手机 上 的 Monkey 进 程 。 具 体 方法 
A 


>adb shell ps |grep monkey 


获取 到 com.android.commands.monkey 的 进程 ID 


>adb shell kill pid 


举例 : adb shell kill 30898 
通过 kill 命 令 杀 死 对 应 的 Monkey 进 程 。 
下 面 来 看 一 个 最 简单 的 Monkey 命 令 行 示例 : 


> adb shell monkey -v 10 


通过 该 命令 启动 Monkey 后 ，Monkey 向 被 测 手 机 的 Android 系 统 发 
送 10 条 随机 事件 流 。 0 手机 上 会 开始 执行 
Monkey 测 试 ， 同 时 在 命令 行 窗口 输出 日 志 ， 执 行 完成 后 ， 可 以 看 到 如 
图 4-3 所 示 的 日 志 


本 管理 员 : CAWindows\system32\cmd.exe || 


C:NUsersNsharonzheng>adb shell monkey -uv 10 
:Monkey: seed=1457751981849 count:=10 
:IncludeCategory: android.intent.category.LAUNCHER 
:IncludeCategory: android.intent.category.MONKEY 

// Allowing start of Intent { cmp=com.tencent.android.qqdownloader/com.qq.AppService.Sta 
in package com.tencent .android.qqdownloader 
// Euent percentages: 


1// 0: 15.6% 
A:/ 1: 196.6X 
J/ 2: 2.0% 
/ 3: 15.6% 
J/ 4: -90.6% 
// 5: 25.6 久 
j/ 6: 15.6% 
p84 Ti 过 6X 
/1/ 8: 2.0% 
// 9: 1.0% 


i/ 10: 13.6% 
:Switch: #Intent;action=android.intent.action.MAIN;category:=:android.intent .category .LAUNCHER 
lags=Qx10200600;component=com.yulong.android.contacts.dial/.DialActivity;end 

// Allowing start of Intent { act=android.intent.action.MAIN cat:=:[android.intent.categor 
ER] cmp=com.yulong.android.contacts.dial/.Dialfctivity } in package com.yulong.android.conta 


:Sending Touch (ACTION_DOWN): 0:(503.0,334.0) 

:Sending Touch (ACTION_UP): 0:(496.58032,335.05844) 

:Sending Touch (ACTION_DOWN): 0:(83.0,761.0) 

Events injected: 10 

:Sending rotation degree:0, persist:false 

:Dropped: keys=0 pointers:=:? trackballs-0 flips:=:Q rotations=9 


Er » 


图 4-3” ”Monkey 执行 的 日 志 输 出 


4.2” Monkey 测试 方法 


了 解 了 Monkey 的 命令 行 参数 、11 大 用 户 事件 、 运 行 环 境 和 命令 行 
使 用 方法 后 ， 这 一 节 将 重点 介绍 Monkey 测 试 在 实际 业务 中 的 运用 方 
法 ， 这 里 包括 常见 的 几 种 测试 方法 以 及 Monkey 日 志 分 析 方法 。 


4.2.1 Monkey 测试 实例 


前 面 介绍 了 Monkey 的 一 些 基础 知识 ， 这 一 节 主 要 介绍 Monkey 测 试 
在 实际 项 目 中 如 何 运 用 。 
1. 常 规 的 稳定 性 测试 

测试 背景 : 


这 是 一 个 海外 的 合作 项 目 ， 被 测 程序 是 Android 应 用 (App) 。 测 
通过 Monkey 来 模拟 用 户 长 时 间 的 随机 操作 ， 检 查 被 测 应 用 是 否 
异常 (应 用 月 江 或 者 无 响应 ) 。 


1 


希望 


会 出 


当 


测试 脚本 : 


adb shell monkey -p com.xxx.xxx --pct-touch 40 --pct-motion 25 --pct-appswitch 
10 --pct-rotation 5 -s 12358 --throttle 400 --ignore-crashes --ignore-timeouts 
-Vv 500000 


显而易见 ， 这 个 Monkey 测 试 的 命令 相 比 上 一 节 提 到 的 要 复杂 得 
， 主 要 是 对 一 些 操 作 事 件 做 了 限制 ， 从 而 减少 了 Monkey 伪 随机 化 的 
无 效 操作 。 这 体现 在 以 下 几 个 方面 。 


Nay 


1) 使 用 -p 参 数 来 制定 测试 应 用 的 包 名 (Package) 


因为 被 测 程序 是 一 个 特定 的 Android 应 用 程序 ， 需 要 指定 被 测 程序 
的 包 名 。 指 定 包 名 后 ，Monkey 会 根据 包 名 找到 对 应 的 应 用 ， 并 局 动 其 


main activity， 然 后 执行 Monkey 测 试 。 


苹 技巧 ”查找 应 用 包 名 的 方法 有 很 多 ， 这 里 简单 列举 几 个 常用 
方法 : 


>adb shell 
>pm list package 


此 时 将 列 出 手机 上 所 有 的 应 用 包 名 ， 在 列表 中 找到 要 测试 的 应 用 
包 名 即 可 。 


(2) 通过 查看 APK 源 码 下 的 AndroidManifest.xml 文 件 。 
(4) 通过 adb logcat 抓 取 当 前 Android 机 运行 的 App 的 包 名 。 


2) 使 用 --pct-xxx 参 数 限制 Monkey 执 行 的 事件 类 型 和 占 比 


前 面 已 经 说 了 ， 这 个 测试 的 目的 是 布 望 模拟 用 户 操作 ， 因 此 需要 
让 Monkey 执 行 的 事件 尽 可 能 地 接近 用 户 的 常规 操作 ， 这 样 才 可 以 最 大 


限度 地 发 现 用 户 使 用 过 程 中 可 能 出 现 的 问题 。 因 此 需要 对 Monkey 执 行 
的 事件 百分比 做 一 些 调整 。 


触摸 事件 和 手势 事件 是 用 户 最 常见 的 操作 ， 所 以 通过 --pctr-touch 和 - 
-pct-motion 将 这 两 个 事件 的 占 比 调整 到 40% 与 25%; 目标 应 用 包含 了 多 
个 Activity， 为 了 能 覆盖 大 部 分 的 Activity， 所 以 通过 --pct-appswitch 将 
Activity 切 换 的 事件 占 比 调整 到 10%; 被 测 应 用 之 前 在 测试 中 出 现 过 不 
少 横竖 屏 之 间 切 换 的 问题 ， 这 个 场景 也 必须 关注 ， 因 此 通过 --pct- 
rotation 把 横竖 屏 切 换 事件 调整 到 10% 。 


3) 使 用 -s 参 数 来 指定 命令 执行 的 seed 值 


Monkey 会 根据 seed 值 来 生成 对 应 事件 流 ， 同 一 个 seed 生 成 的 事件 
流 是 完全 相同 的 。 这 里 指定 了 seed 值 ， 是 为 了 测试 发 现 问题 时 ， 便 于 进 


4) 使 用 --throttle 参 数 来 控制 Monkey 每 个 操作 之 间 的 时 间 间 隔 


指定 操作 之 间 的 时 间 间 隔 ， 一 方面 是 希望 能 更 接近 用 户 的 操作 场 
景 ， 正 常用 户 操作 都 会 有 一 定 的 时 间 间 隔 ; 另 一 方面 也 是 不 希望 因为 
过 于 频繁 的 操作 而 导致 系统 前 总 ， 尤 其 是 在 比较 低 端的 手机 上 执行 测 
试 时 。 因 此 通过 --throttle 设 置 Monkey 每 个 操作 固定 延迟 0.4 秒 。 


5) 使 用 --ignore-crash 和 --ignore-timeouts 参 数 使 Monkey 遇 到 意外 时 


在 执行 Monkey 测 试 时 ， 会 因为 应 用 的 崩 汝 或 没有 响应 而 意外 终 
止 ， 所 以 需要 在 命令 中 增加 限制 参数 --ignore-crash 和 --ignore-timeouts， 
让 Monkey 在 遇 到 裔 省 或 没有 响应 的 时 候 ， 能 在 日 志 中 记录 相关 信息 ， 
并 继续 执行 后 续 的 测试 。 


6) 使 用 -v 指 定 log 的 详细 级 别 


Monkey 的 日 志 输 出 有 3 个 级 别 : 默认 的 是 level 0，-v-v 日 志 级 别 为 
level 1，-v-v 日 志 级 别 为 level 2。 日 志 的 级 别 越 高 ， 其 详细 程度 也 越 
高 。 为 了 方便 问题 的 定位 ， 将 日 志 级 别 设置 为 level2 。 


在 音 规 的 稳定 性 测试 中 ， 虽 然 可 以 目 定 义 各 种 事件 的 操作 后 比 ， 
但 毕竟 是 随机 事件 流 。 在 实际 测试 过 程 中 ， 难 免 会 遇 到 Monkey 点 了 我 
们 不 希望 它 点 击 的 地 方 ， 比 如 误 点 了 工具 栏 寻 致 网 络 断 开 的 情况 等 。 
当 测 试 过 程 中 Wi-Fi 断 开 时 ， 是 否 有 可 能 目 动 重 连 呢 ? 在 后 面 的 章节 中 
会 介绍 如 何 解决 这 个 问题 ， 大 家 可 以 市 着 这 个 问题 继续 往 下 看 。 


2. 目 定义 脚本 的 稳定 性 测试 


常规 Monkey 测 试 执行 的 是 随机 的 事件 流 ， 但 如 果 只 是 想 让 Monkey 
测试 某 个 特定 场景 执行 固定 的 事件 流 ) 呢 ? 这 时 候 就 需要 用 到 有 自 定 


义 脚本 了 ，Monkey 文 持 执行 用 户 自 定 义 脚本 的 测试 ， 用 户 只 需要 按照 
Monkey 脚 本 的 规范 编写 好 脚本 ， 和 存放 a 到手 机上， 局 动 Monkey 通 过 -f 
scriptfile 参 数 调 用 脚本 即 可 。 


Monkey 目 定义 脚本 的 编写 模板 如 代码 清单 4-1 所 示 。 
代码 清单 4-1 Monkey 目 定义 脚本 的 编写 模板 


# 头 文件 ， 控 制 


MonKkey 发 送 消息 的 参数 ， 固 定 写 即 可 


# 脚 本 类 型 ， 一 般 不 用 更 改 


type=raw events 
# 脚 本 执行 次 数 ， 但 是 由 于 


Monkey 命 令 本 身 可 以 指定 执行 次 数 ， 所 以 这 里 的 设置 是 不 生效 的 


count=10 
# 命 令 执行 速率 ， 速 率 也 可 以 通过 


Monkey 命 令 设置 ， 这 里 的 设置 是 不 生效 的 


speed=1.0 
# 以 下 为 


Monkey 命 令 
start data>> 
LaunchActivity ( 


pkg_name, cl_name) 


Dispatchpress(KEYCODE_HOME).. 


Monkey 脚 本 常见 API 见 表 4-6。 


表 4-6” Monkey 脚本 常见 API 


API 


说 明 


LaunchActivity(Pkg name.cl_ 


name) 


Tap(x,y.tapDuration) 


DispatchPress(keyName) 


RotateScreen(rotationDeeree,pere 
slst) 


DispatchFlip(true/false) 


启动 被 测 应 用 的 某 个 Activity 
Pkg_name: 包 和 名 

cl_ name: Activity 名 

横 拟 一 次 手指 单 击 事 件 
x: 点 击 的 横 坐 标 

y: 点 击 的 纵 坐 标 
tapDuration: 按 下 的 时 长 ， 
模拟 按键 点 击 


单位 是 起 ms 


keyName: 按键 的 名 称 
模拟 旋转 屏幕 
rotationDegree: 用 0 ~ 3 分别 表示 顺 时 针 旋 转 的 四 个 方向 


peresist: 是 否 存留 


打开 或 关闭 软 键盘 


LongPress() 


长 按 两 秒 


PressAndHold(x.y.PressDuration) 


DispatchString(input) 


Drag(xStart,yStart,xEnd.yEnd.ste 
pCount) 


模拟 长 按 事 件 : 即 单 指 按 下 
x: 点 击 的 横 坐 标 
y: 点 击 的 纵 坐 标 
点 击 时 长 y 


“ 段 时 间 ， 再 抬 起 


pressDuration: 单位 是 ms 

输入 字符 串 

输入 内 容 

模拟 拖 动 操作 : 即 单 指 按 下 、 拖 动 、 放 开 
xStart、yStart: 起 始 的 横 坐 标 和 纵 坐 标 
xEnd、yEnd: 结束 的 横 坐 标 和 纵 坐 标 

移动 的 事件 数 (可 理解 为 移动 速度 ) 


input: 


stepCount: 


API 


说 明 


PinchZoom(ptlxStart, ptlyStart, 
ptlxEnd, ptlyEnd., pt2xStart, 
pt2yStart, pt2xEnd, pt2yEnd, 
stepCount) 


UserWait(sleepTime) 


DeviceWakeUPp() 


模拟 缩放 手势 : 即 两 个 手指 同时 按 下 并 移动 ， 再 同时 放 开 
ptlxStart、ptlyStart: 手指 1 起 始 的 横 坐 标 和 纵 坐 标 
ptlxEnd、ptlyEnd: 手指 1 结束 的 横 坐 标 和 纵 坐 标 
pt2xStart、pt2yStart: 手指 2 起 始 的 横 坐 标 和 纵 坐 标 
pt2xEnd、pt2yEnd: 手指 2 结束 的 槛 坐标 和 纵 坐 标 
stepCount: 移动 的 事件 数 (可 理解 为 移动 速度 , step Count 越 大 


设置 等 待 时 间 


sleepTime: 等 待 的 时 间 ， 单 位 是 ms 
唤醒 屏幕 


移动 速度 越 慢 ) 


各 技巧 ”Monkey 脚 本 只 能 通过 坐标 的 方式 来 定位 点 击 和 移动 事 
件 的 屏幕 位 置 ， 这 里 就 需要 提前 获取 坐标 信息 。 获 取 坐 标 信息 的 方法 
很 多 ， 最 简单 的 方法 就 是 打开 手机 中 的 开发 人 员 选 项 ， 打 开 “ 显 示 指 针 
位 置 "。 随后， 在 屏幕 上 的 每 次 操作 ， 在 导航 栏 上 都 会 显示 坐标 信息 。 


下 面 来 看 一 个 商 单 的 例子 : 


这 里 要 测试 的 是 应 用 宝 App， 测 试 的 操作 是 打开 应 用 宝 ， 扩 击 输 入 
框 ， 输 入 “yyb”"， 点 击 搜索 。 搜 索 完成 后 ， 扩 击 运 回 键 返 回应 用 宝 上 有 
pi 


~ 


首先 ， 将 在 本 地 编写 需要 的 测试 脚本 命名 为 monkey.script (文件 格 
式 无 要 求 ) ， 脚 本 内 容 如 代码 清单 4-2 所 示 。 


代码 清单 4-2 Monkey 自 定义 脚本 实现 进入 应 用 宝 进 行 搜 索 


# 启 动 测试 


type = user 
count = 49 
speed = 1.0 
start data >> 
# 启 动 应 用 宝 


LaunchActivity(com.tencent.android.qqdownloader,com.tencent.assistant.activity.Spl 
ashActivity) 

Userwait(2000) 

# 点 击 搜索 杠 


Tap(463,150,1000) 
Userwait(2000) 
# 输 入 字母 “ 


yyb” 


Dispatchstring(yyb) 
Userwait(2000) 
# 点 击 搜索 


Tap(960, 150, 1000) 
Userwait(2000) 
## 点 击 返 回 键 返回 首页 


DispatchPress(KEYCODE_BACK) 


其 次 ， 将 文件 push 到 手机 或 模拟 絮 的 sdcard 中 : 


>adb push monkey.script /sdcard/ 


最 后 ， 执 行 脚本 : 


>adb shell monkey -f /sdcard/monkey.script - 


v1 


此 时 可 以 看 到 手机 按照 前 面 的 脚本 开始 执行 了 ， 命 令 行 窗 口 输出 
的 结 采 如 图 4-4 所 示 。 


:Usersvsharonzheng7yadb shell 
rooctecoolpad82937:/ # ionkey -f /sdcard/monkeyscript.txt -uv 1 
onkey -Ff /sdcard/monkeyscript ,txt -u 1 
:Nonkey: seed=195774SHON267 countz1 
:IncludeCategory: android.intent .category.LAUNCHER 
:IncludeCategory: android.intent.category.MONKEY 
Replaying D euents with speed 1.0 
;Switch: 州 Intent;actionsandroid.intent ,action, MAIN;categoryandroid, intent ,category, LAUNCHER; 1aunch 
lags:Ox10200866;component:com.tencent .android.qqdounloader /com. tencent .assistant .activity.SplashAct 
ity;end 
/f/f Allowing start of Intent { act:android, intent.action.HAIN cat=[android.intent .category .LAUNC 
R] cmp:com,tencent,android, qqdownloader/com, tencent ,assistant ,activity, Splashhctivity } in package 
om, tencent ,android, qqdounloader 
AAA/ Allowing start of Intent { cmp:com.tencent.android.gqqdownloader/com.tencent.assistanty2.acti 
ity.MainActivity } in package con.tencent .android. qqdounNloader 
lf activityResuming( com, tencent .android, qqdounloader) 
:Sending Touch (ACTION_DOWN); G;(463,0,150.9) 
:Sending Touch (ACTION UP): 6:(463.6,156.6) 
/1 Shell command input text yyb status was 日 
:Sending Touch (8CTION_DOWN) ，8:(3969.9,159.91) 
:Sending Touch (ACTION_UP): 9:(9560.6,156.0) 
Euente injected: 13 
:Sending rotation degree:Q, persist=false 
1:Dropped: Keys:2 pointers:y4 trackballs=B flips:Q rotations=0 
惠 # Notuork stats: olapsoed timo=:8902ms (Oms mobile, S902ns wifi, Oms not connected) 
/ Nonkey finished 
el 


图 4-4 命令 行 窗口 输出 的 结果 


从 手机 上 可 以 看 到 ，Monkey 按 照 脚本 启动 了 应 用 宝 ， 随 后 点 击 搜 
索 框 ， 输 入 “yyb”， 点 击 搜索 ， 如 图 4-5 和 图 4-6 所 示 。 


QQ 空间 后 。 。” 领 + 元 现金 


新 春 线 前 了 加 岁 可 提现 支付 宝 


图 4-5 ”脚本 启动 应 用 宇 


72% 的 用 户 搜索 该 词 后 下 载 


人 应 用 宝 嘻 
罗 符 涂 资源 并 犯 有 琵 齐 全 | 


gaing eeag 


0.4 万 人 人 下载 


图 4-6 点击 搜索 框 ， 搜 索 “yyb” 


名 二 1 门 ”如 果 需 要 重复 执行 某 个 脚本 ， 只 要 在 Monkey 启 动 命令 
中 修改 执行 次 数 即 可 。 例 如 ; 


adb shell monkey -f /sdcard/monkey.script - 


Vv 10 
此 时 Monkey 会 重复 执行 monkey.script 脚 本 10 次 。 


3. 结 合 辅助 命令 ， 获 取 更 多 信息 


种 规 测试 只 要 记录 下 Monkey 日 志 ， 再 分 机 Monkey 日 志 检 查 是 人 否 有 
种 即 可 。 但 是 ， 很 多 时 候 ， 测 弃 除 了 想 知道 执行 过 程 羡 否 有 有 异 闻 ， 
还 需要 能 获取 执行 过 程 中 的 一 些 详细 信息 或 性 能 数据 ， 比 如 想 知道 
Monkey 执 行 过 程 中 是 否 存 在 内 存 泄漏 ， 需 要 获取 内 存 信息 。 这 时 候 就 
需要 借助 一 些 辅助 的 命令 来 获取 更 多 信息 了 。 下 面 列 举 了 几 种 Monkey 
测试 中 党 用 的 辅助 命令 ， 使 用 方法 也 非常 簿 单 ， 只 要 在 执行 Monkey 的 
同时 ， 男 起 一 个 CMD 命 令 行 窗口 输入 对 应 命令 执行 即 可 。 


站 


.获取 logcat 日 志 信 息 : 


adb Shel1 logcat -v time>log.txt 


-获取 内 存 信息 : 


adb shell dumpsys meminfo < 进程 名 


> 


获取 CPU 请 耗 信 息 : 


adb shell top - 


n 1 |find “进程 名 ” 


-获取 电量 信息 : 


adb shell dumpsys battery 


.获取 GPU 信息 : 
GPU 信息 命令 : 


adb shell dumpsys gfxinfo < 进程 名 


> 


-获取 流量 信息 : 


adb shell cat/proc/uid_stat/< 被 测 应 


TH 
a 


uid>/tcp_rcv 


名 技巧 ”如 何 获取 被 测 应 用 的 UID 


步骤 1: 查看 被 测 应 用 的 进程 ID (PID) 


adb Shel1 ps | grep < 被 测 应 用 包 名 


> 


步骤 2: 查看 被 测 应 用 的 用 户 ID (UID) 


adb shell cat /proc/$pid/status 


4.Monkey 测 试 策略 制定 思路 


前 面 介 绍 了 几 种 常见 的 Monkey 测 试 方法 ， 但 在 实际 项 目 中 ， 选 择 
哪 种 Monkey 测 试 策略 ， 则 需要 根据 实际 项 目的 情况 来 做 判断 。 主 要 是 
看 测试 目的 及 被 测 应 用 目 身 的 特点 。 假 如 我 们 想 测 弃 浏 蜗 志 的 双 指 缩 


放 功 能 是 否 有 异常 ， 那 就 需要 选择 --pct-pinchzoom 参 数 ， 调 大 双 指 缩放 
事件 的 占 比 进行 Monkey 测 试 ， 假 如 我 们 想 验 证 ROM 的 横 坚 屏 切换 功能 
是 否 正常 ， 那 就 需要 选择 --pct-rotation 参 数 ， 调 大 横竖 屏 切 换 事 件 的 占 
比 进行 Monkey 测 试 ， 假 如 我 们 想 验 证 重复 某 种 特定 操作 时 ， 应 用 是 否 
会 存在 异 弟 ， 那 可 以 选择 -f 参 数 ， 目 定义 Monkey 脚 本 进行 验证 ， 假 如 
我 们 想 验 证 长 时 间 操 作 时 应 用 是 否 会 存在 内 存 泄漏， 那 就 需要 结合 - 
hprof 参 数 和 dumpsys meminfo< 进 程 名 > 进行 Monkey 测 试 。 


总 之 ，Monkey 测 试 策略 是 需要 依据 测试 目的 和 被 测 程序 的 特点 来 


4.2.2 ”Monkey 日 志 分 析 


Monkey 日 志 分 析 是 Monkey 测 试 中 非常 重要 的 一 个 环 广 ， 通 过 日 志 
分 析 ， 可 以 获取 当前 测试 对 象 在 测试 过 程 中 是 否 会 发 生 异 常 ， 以 及 发 
生 的 概率 ， 同 时 还 可 以 获取 对 应 的 错误 信息 ， 帮 助 开 发 定位 和 解决 问 
题 。 介 绍 日 志 分 析 方法 之 前 ， 移 来 看 一 下 日 志 的 保存 方法 。 


1.Monkey 日 志 的 保存 方法 
Monkey 运 行 日 志 常 见 的 保存 方法 有 三 种 : 
保存 在 PC 中 ， 代 码 如 下 : 


>adb shell monkey [option] <count> >d:\monkey.txt 


执行 以 上 命令 ，Monkey 的 运行 日 志 将 被 保存 在 PC 上 的 D 盘 下 的 一 
个 monkey.txt 文 件 中 。 


-保存 在 手机 中 ， 代 码 如 下 : 


>adb shell 
>monkey [option] <count> > /mnt/sdcard/monkey .txt 


执行 以 上 命令 ，Monkey 的 运行 日 志 将 被 保存 在 手机 中 的 SD 卡 上 的 
一 个 monkey.txt 文 件 中 。 


-标注 流 与 错误 流 分 开 保存 ， 代 码 如 下 : 


Monkey [option] <count> 1>/sdcard/monkey.txt 2>/sdcard/error.txt 


执行 以 上 命令 ，Monkey 的 运行 日 志和 异常 日 志 将 被 分 开 保存 。 此 
时 Monkey 的 运行 日 志 将 被 保存 在 monkey.txt 文 件 中 ， 而 异常 日 志 将 被 傈 
存在 D 盘 下 的 errortxt 中 。 


执行 结束 后 ， 可 以 看 到 SD 卡 上 新 增加 了 monkey.txt 和 errortxt 。 


二 


monkey.txt 显 示 运 行 日 志 ， 如 图 4-7 所 示 。 


errarsbt 一 monkeybdt x 
OB DD ND 
3 :Monkey: seed=1454301328162 count=10 
2 :BllowPackage: com.tencent.android.qqdidownloader 
3 :IncludeCategory:; android.intent.category.LAUNCHER 
4 :IncludeCatcgory: android.intent.catcgory.MONKEY 


5 // Event percentages: 
下 // D: 15.0% 


1/ 1: 10-0 引 
8 /7/ 2: 2.0$ 
9// 3: 15.0% 
10 // 4: -0.0% 
11 // 5: 25.0% 
42 // 6: 15.0% 
13 // 7: 2.0% 
1¢ // 8B: 2-.0% 


I // 9: 1.0s% 

16 // 10: 13.04 

17 :3Swltch: #Intent;acticon=aendroid.intent.action.MAIN; catecgory=android.intent.category .LAUNCIHER,; 
// Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.catcgor] 

49 < Monkey eborted due to error. 

20 Events injeccted;: 2 

2 :3cndlng rotation degreec=0, persist=falye 

22 :DIropped: keys=0 pointers=0 trackballs=0 flips=0 rotationo=0 

23 ## Network stats: elapsed time=380ms (Oms mobile, Dms wifi, 380Oms not connected) 

24 


图 4-7 运行 日 志 输 出 


如 果 Monkey 执 行 期 间 存 在 Crash ( 册 尝 ) 或 ANR (Application Not 
Responding， 应 用 程序 无 响应 ) ，error.txt 中 会 显示 错误 日 志 ， 如 图 4-8 


所 示 。 


errorixt x 


ll Al UD 
I/ TRASH: com.tencent.-android.qqdowninader (Piq 15253) 

// Short Mog: ijava.lang.ClasoNotFoundExccption 

// Long Msg: java.lang.ClassNotFoundException: Didn't find class "com.qq-MppService.AstApp" on path: De 
7/ Build Label: Xiacmi/pisces/pisceg:4.4.4/KTUB84P/5.12.24:user/release-keys 

// Build Changelist: 5.12.24 

// Build Time: 1450358964000 

// java.lang-RuntimeFxception: Unable to instantiate application com.qq-appServjce.asbapp: java.lang.ce 
// at android.app.LoadedApk.makcApplication (Loadecdapk. jave;509) 

/1/ at android.app .ActivityThread.handleDindApplication (ActivityThread, jave;4314) 

10 // at android.app.ActivityThread.access$1500 (ActivityThread.java:138) 

1i // at android.app.nctivityThread$n.handleMessage (ActivityThread.java:1261) 

12 // ar android.os.Handler,.dispatchMessaage (Handler.java:102) 

i3 // at android.os.Looper.loop (Looper.java:136) 

14 // at android.app .RActivityThread.main(ActivityThread.java:5016) 

15 // at jara.lang.reflcct.Mcthod.invokcNative (Native Mcthod) 

16 // at java.lang.reflect.Method.invoke (Method.Jjava:515) 

17 // at com-.android.internal.os.2ygoteInit$MethodNndnrgsCaller.run(2ygoteInit.java:792) 

i8 // at com-.android.internal.nos.2ygotelInit.main(2ygoteInit.java:608]) 

i9 // at dalvik.system.Nativestart.main(Native Method) 

20 // Caused by: java.lang.ClassNotFoundException: Didn't find class "com.qq.AppService.AstApp" on path: I 
22 // at dalvik.system.BascDcxClassLoader .findClass (BascDecxClassLoader. Jave:56) 

22 // at java.lang.ClassLoader.loadclasa (ClassLoader.Java:497) 

23 // at Java.lang.ClassLoader.loadCclass(ClassLoader.Java:457) 

24 // at android.app.Instrumentation.newApplication(Instromentation.java:375) 

25 // at android.app.Loadedapk.makenpplication(Loadedapk.ijava:504) 


本 四 上 四 kw 


oo 


wv 


图 4-8 ” 异 币 日 志 输 出 
2.Monkey 日 志 内 容 解 析 


Monkey 运 行 时 输出 的 日 志 一 般 包含 四 类 信息 ， 分 别 是 涡 
` 伪 随机 事件 流 信息 、 异 党 信息 、Monkey 执 行 结果 信息 


[© 


Monkey 启 动 后 会 输出 当前 所 执行 命令 的 各 种 参数 信息 ， 其 中 包括 
种 子 (Seed) 信息 、 事 件数 量 、 可 运行 的 应 用 列表 以 及 各 事件 百 分 
等 。 这 些 信息 都 是 通过 Monkey 命 令 参 数 所 指定 的 ， 这 部 分 日 志 信 息 的 
解析 ， 如 代码 清单 4-3 所 示 。 


代码 清单 4-3” Monkey 日 志 - 测 试 命令 信息 


/ /测试 命令 信息 


/ /随机 种 子 值 ， 执 行事 


件数 量 


:Monkey: Seed=1454215444564 count=10 
/ /可 运行 的 应 用 列 3 


:AllowPackage: com.tencent.android.qqdownloader 
//Category 包 含 


LAUNCHER 和 


MONKEY 

:IncJudecategory: android,intent ,category,LAUNCHER 
:IncludeCategory: android,intent .category,MONKEY 

/ /各 事件 的 百分比 


// Event percentages: 
// 0: 15.0% 事件 


0 


--pct-touch 
// 1: 10.0% 事件 


1 


--pct-motion 
// 2: 2.0% 事件 


2 


--pct-pinchzoom 
// 3: 15.0% 事件 


3 


--pct-trackball 
// 4: -0.0% 事件 


4: 


--pct-rotation 
// 5: 25.0% 事件 


5 


--pct-nav 
// 6: 15.0% 事件 


6 


--pct-majornav 
// 7: 2.0% 事件 


洲 


--pct-syskeys 
// 8: 2.0% 事件 


8 


--pct-appswitch 
// 9: 1.0% 事件 


9 


--pct-flip 
// 10: 13.0% 事件 


10: 


--pct-anyevent 


2) 伪 随 机 事件 流 信 息 


当 Monkey 开 始 执行 测试 后 ， 会 顺序 输出 执行 的 事件 流 信息 ， 主 要 
征 前 面 提 到 的 11 大 事件 。 这 部 分 日 志 信息 的 解 机， 如 代码 清单 4-4 所 


示 “。 
代码 清单 4-4 Monkey 日志-- 伪 随机 事件 流 信息 


/ /执行 的 事件 流 信 ， 


于 
最 


// 启 动 


App 事 件 


:Switch: 
#Intent;action=android.intent.action.MAIN;category=android.intent.category .LAUNCHE 
R;launchFlags=0x10200000;component=com.tencent.android.qqdownloader/com.tencent.as 
sistant.activity.SplashActivity;end 

// Allowing start of Intent { act=android.intent.action.MAIN cat= 
[android.intent.category .LAUNCHER] 

cmp=com. tencent.android.qqdownloader/com.tencent.assistant.activity.SplashActivity 
} in packagecom.tencent.android.qqdownloader 

/ /轨迹 球 事件 


:Sending Trackbal1 (ACTION_MOVE): 0:(4.0,2.0) 
/ /点 击 事件 


:Sending Touch (ACTION_DOWN): 0:(387.0,1858.0) 
:Sending Touch (ACTION_UP): 0:(385.8215,1861.3011) 
// 延 时 


Sleeping for © milliseconds.. 


当 Monkey 执 行 过 程 中 过 到 错误 时 ， 会 输出 对 应 异常 信息 ， 如 代码 
清单 4-5 所 示 。 


代码 清单 4-5 ”Monkey 日 志 - 异 


El 
一 > 
ll 


// 发 送 


Crash 的 应 用 包 名 和 


pid 
// CRASH: com.tencent.android.qqdownloader (pid 912 ) 
/VCrash 的 简要 信息 


// Short Msg: java.lang.ClassNotFoundException 
/VCrash 的 详细 信息 


// Long Msg: java.lang.ClassNotFoundException: Didn't find class "com. 
qq.AppService.AstApp" on path DexPathList[[zip file "/data/app/com.tencent. 
android.qqdownloader-2.apk"],nativeLibraryDirectories[/data/app-1lib/com. 
tencent.android.qqdownloader-2, /vendor/lib, /system/1ib]] 

// 机 型 和 系统 信息 


// Build Label: Xiaomi/pisces/pisces:4.4.4/KTU84P/5.12.24:user/release-keys 
// Build Changelist: 5.12.24 

// Build Time: 1450958964000 

//Crash 的 详细 日 志 


// java.lang.RuntimeException: Unable to instantiate application com. 
qq.AppService.AstApp: java.lan.ClassNotFoundException: Didn't find class "com. 
qq.AppService.AstApp" on path: DexPathList[[zip fil "/data/app/com.tencent. 
android.qqdownloader-2.apk"],nativeLibraryDirectories=[/data/app-1ib/com. 


tecent.android.qqdownloader-2, /vendor/lib, /system/1ib]] 
// at android.app.LoadedApk.makeApplication(LoadedApk.java:509) 


// at android.app.ActivityThread.access$1500(ActivityThread.java:138) 
// at dalvik.system.NativeStart.main(Native Method) 

// ... 11 more 

// 


4) Monkey 执 行 结果 信息 


当 Monkey 执 行 完 所 有 事件 后 ， 会 输出 执行 结果 信息 ， 其 中 包括 执 
行 的 事件 数量 、 旋 转 的 角度 、 丢 失 的 事件 数量 、 网 络 状态 以 及 Monkey 
最 终 的 执行 结果 ， 如 代码 清单 4-6 所 示 。 


代码 清单 4-6 Monkey 日 志 - 执 行 成 功 结果 信息 


/ /执行 的 事件 数量 


Events injected: 10 
/ /旋转 的 角度 为 


0 
:Sending rotation degree=0, persist=false 
/ /丢失 的 事件 数量 


:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0 
/ /网 络 状态 ， 移 动 网 络 联网 


gms 

Wi -FI 联网 
0ms， 没 联网 
144ms 


## Network stats: elapsed time=144ms (QOms mobile, Oms wifi, 144ms not connected ) 
// Monkey finished 


如 采 Monkey 执 行 过 程 中 出 现 了 异常 导致 执行 失败 ， 会 输出 对 应 的 
执行 失败 的 原因 ， 第 几 个 事件 执行 失败 以 及 所 使 用 的 随机 种 子 数 ， 如 


代码 清单 4-7 所 示 。 
代码 清单 4-7 Monkey 日 志 - 执 行 失败 结果 信息 


/ /显示 


Monkey 执 行 失败 


** Monkey aborted due to error. 
/ /执行 的 事件 数量 


Events injected: 8 
/ /旋转 的 角度 为 


0 
:Sending rotation degree=0, persist=false 
/ /丢失 的 事件 数量 


:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0 
/ /网络 状 态 


## Network stats: elapsed time=405ms (QOms mobile, QOms wifi, 405ms not connected) 
/ /提示 在 执行 到 第 


8 


事件 时 出 现 


— 


Crash， 以 及 所 使 用 的 随机 种 子 的 值 


** System appears to have crashed at event 8 of 100 using seed 1454216848235 


3.Monkey 日 志 异 常 信息 查 找 


Monkey 执 行 过 程 中 常见 的 错误 类 型 主要 有 两 类 : 应 用 程序 无 响应 
(ANR) 和 裔 站 (Crash) 。 


ANR 是 指 当 Android 系 统 监测 到 应 用 程序 在 5 秒 内 没有 响应 输入 的 
事件 或 广播 在 10 秒 内 没有 执行 完毕 时 抛 出 无 啊 应 提示 。 当 出 现 ANR 时 


弹出 的 错误 提示 框 如 岁 4-9 所 示 。 


Crash 是 指 当 应 用 程序 出 现 错误 时 导致 程序 异常 停止 或 退出 的 情 
况 ， 当 出 现 Crash 时 通 第 会 弹出 对 应 的 错误 提示 框 如 图 4-10 所 示 。 


应 用 宝 无 响应 。 
要 将 其 关闭 吗 ? 


图 4-10 ”Crash 弹 窗 


要 统计 Monkey 日 志 中 错误 出 现 的 次 数 也 非常 简单 ， 只 要 搜索 关键 
字 “ANR” 和 “CRASH” 出 现 的 次 数 即 可 。 由 于 通常 Monkey 测 试 的 日 志 会 
比较 大 ， 日 志 内 容 也 非常 多 ， 为 了 简化 统计 操作 ， 可 以 使 用 bat 脚 本 进 
行 统计 ， 具 体 如 代码 清单 4-8 所 示 。 


代码 清单 4-8 ”Monkey 日 志 分 析 bat 脚 本 


@echo off&setlocal enabledelayedexpansion 
# 设 置 所 有 


Monkey 日 志 存 放 的 目录 


Set ff=log\*.txt 
# 设 置 查询 关键 字 


set Str=CRASH crash ANR died 
# 设 置 查询 结果 存放 的 目录 


set fileName=Result.txt 
# 开 始 查询 


echo 正在 统计 


&echo; 
echo %date% %time% >%fileName% 
echo.>>%fileName% 

echo 分 析 结 果 : 


>>%fileName% 
echo -i >>%fileName% 
# 依 次 打开 目录 下 每 一 个 


MonKkey 日 志 查询 关键 字 并 输出 个 数 


(for %%a in (%str%)do ( 
set n%%a=O&set/p=  %%a : <nul>con 
for /f "delims=" %%b in ('findstr "%%a" "%ff%"')do ( 
set h=%%b 
call :yky %%a) 
echo !n%%a!>con 
echo 关键 字 


%9%6a 月 
1n%%al!l 处 
) )>>%fileName% 


echo.>>%fileName% 
# 针 对 毅 溃 的 日 志 输 出 其 所 在 文件 行 数 


echo 崩溃 日 志 : 


>>%fileName% 

findstr "%str%" "%ff%">>%fileName% 
echo/&pause&exit 

‘yky 

set/a n%1i+=1 

set h=!h:*%1=! 

if defined h if not "!h:*%1=!"=="!h!" goto :yky 


终 执行 后 ， 在 脚本 目录 下 会 生成 Result.txt 文 件 记录 异常 


数 ， 如 图 4-11 所 示 。 


了 Result:bd - 记事 本 
文件 昌 “ 编 得 (E) “格式 (O) ”查看 (WV) 帮助 (H) 


出 现 的 次 


eo 


2013A11/01 周 五 9:22:05.02 
分 析 结果 ， 


关键 字 CRASH 共有 2 处 
天 键 crash 共有 0 处 
奖 健 于 AR 共有 1 


ANR 
奖 则 于 died “共有 0 
崩溃 日 志 ; 


log\com. android. settings. txt:// CRASH: com. android. settings (pid 29940) 


图 4-11 日 志 分 析 结 果 文 件 


根据 统计 结 采 ， 可 以 得 到 Crash 和 ANR 出 现 的 次 数 ， 


log\com. google. android. browser. txt:// CRASH: com. google. android. browser (pid 11255) 


以 及 出 现在 哪 


日 志文 件 中 ， 出 现 该 错误 的 包 名 。 如 果 需 要 更 详细 的 错误 信息 ， 可 


以 打开 对 应 的 Monkey 日 志文 件 查询 。 
位 到 引起 Crash 的 原因 ， 
一 些 Crash 错 误 信 息 ， 见 表 4-7 。 


表 4-7 常见 Crash 信 息 表 


Crash 关键 字 
Java.lang.NullPointerException 
Java.lang.ArrayIndexOutOfBoundsException 
Java.lang.ClassNotFoundException 
Java.lang.ArithmeticException 
Java.lang.IllegalAreumentException 
Java.10.FileNotFoundException 
Java.lang.NumberFormatException 
Java.lang.StackOverflowError 


Java.lang.OutOfMemoryError 


Crash 原因 


空 指针 异常 


数组 洪 出 
类 不 存在 
数学 :运算 异常 帅 


方法 参数 异常 


文件 未 找到 


数值 转化 异常 


堆栈 异常 错误 


| a| 存 溢出 错误 


过 详细 卓志 AM 吾 言 筷 y 测试 可 以 定 


以 及 出 现 Crash 的 代码 行 信息 。 这 里 给 出 常见 的 


当 获 取 到 Crash 和 ANR 日 志 信 息 后 ， 理 论 上 开发 人 员 就 可 以 开始 根 
据 日 志 内 容 分 机 和 定位 问题 了 。 但 事实 上 ， 要 定位 问题 单 靠 日 志 信息 
还 是 非常 困难 的 ， 有 时 候 开 发 人 员 还 需要 知道 问题 复 现 的 场景 ， 同 时 
增加 更 多 的 调试 日 志 以 协助 定位 。 这 时 候 ， 他 们 可 能 会 期 望 测试 能 够 
复 现 问题 或 者 提供 问题 出 现场 景 和 操作 步 又。 通常 ， 测 试 人 员 可 以 通 
过 使 用 同一 个 种 子 数 (seed 值 ) ， 再 次 执 4 ee 
这 种 方法 比较 费时 ， 并 且 不 是 所 有 的 随机 Crash 和 ANR 都 可 以 通过 这 种 
方法 来 复 现 。 那 问题 来 了 ， 在 Monkey 出 现 问题 的 时 候 有 没有 可 能 即时 
地 截图 并 且 记 录 下 操作 步骤 昵 ? Monkey 本 身 是 没有 这 个 能 力 的 ， 但 是 
通过 一 些 Monkey 改 造 可 以 实现 该 功能 。 在 4.4 克 会 详细 介绍 Monkey 改 
造 的 方法 ， 大 家 不 妨 带 着 这 个 问题 继续 往 下 看 。 


4.3 Monkey 的 基本 原理 


前 面 介 绍 了 Monkey 的 各 种 参数 以 及 其 基本 使 用 方法 ， 顺 市 提 到 了 
在 实践 中 Monkey 页 存在 一 定局 限 性 ， 比 如 Monkey 本 号 是 不 文 持 截 
的 ，Monkey 执 行 过 程 中 网 络 断 开 后 无 法 文 持 目 动 重 连 ， 等 等 。 针 对 这 
些 问 题 ， 可 以 通过 改造 Monkey 源 码 的 方式 来 实现 。 接 下 来 这 一 市 将 重 
所 介绍 Monkey 的 代码 框架 及 其 内 部 实现 逻辑 ， 帮 助 大 家 更 好 地 了 解 
Monkey 十 怎样 工作 的 ， 为 接 下 来 的 4.4TMonkey 源 码 改造 打 好 基础 。 
让 我 们 先 从 Monkey 的 代码 框架 入 手 。 


4.3.1 _ Monkey 代码 框架 


前 面 说 到 了 Monkey 程 序 由 一 个 名 为 “monkey” 的 shell 脚 本 来 启动 执 
， 该 脚本 在 Android 文 件 系统 中 的 存放 路 径 是 : /system/bin/monkey 。 
里 简单 解释 一 下 此 脚本 ， 如 下 面 的 代码 所 示 。 


# 将 

base 设 为 

SYStem 路 径 
base=/system 

# 将 

monkey . jar 路 径 设 置 为 
CLASSPATH 环 境 遍历 
export CLASSPATH=$base/framework/monkey .jar 
trap "" HUP 

## 通 过 
app_process 命 令 启 动 


Monkey 
exec app_process $base/bin com.android.commands ,monkey .Monkey $* 


过 脚本 不 难 发 现 ， 该 批 处 理 通过 app_process 命 令 指 同 的 是 手机 
上 framework 目 录 下 的 一 个 monkey.jar 包 中 
的 “com.android.commands.monkey.Monkey” 类 (这 个 类 即 为 Monkey 的 入 
口 函数 所 在 类 ) 。monkey.jar 的 源码 位 于 Android 源 人 码 
的 \development\cmds\monkey\src\com\android\commands\monkey” 目 录 


下 ， 如 图 4-12 所 示 。 


日 -: 唱 gingerbread_2.3.1 


由 -看 bionic 
由 - 国 bootable 
由 -看 build 

由 国 t 

由 - 国 dalvik 


| 
|‖ 国 Monkeyjava 

| 国 MonkeyActivityEventjava 

| 国 MonkeyComrmandEventjava 
| 国 MonkeyEvent,jjava 


日 -最 developrnent 
”和 申 出 apps 
”外 -上 腊 build 
| 日- 山 cmds 
| | 白 - 园 monkey 
白 - 最 src 
日 -最 com 
日 - 轧 android 
日 -最 commands 


| 竺 MionkeyEventQueue.java 

| 曾 NonkeyEventSource,ava 

| 国 MonkeyFlipEventjava 

| 国 NonkeyInstrumentationEvent,ava 
| 国 NonkeyKeyEvent,ava 

| 司 IMonkeyfvlotionEventjava 

| 竺 | NonkeyNetworkNonitor,ava 


| 国 MonkeyNoopEventjjava 

| 国 MonkeypPowerEvent,java 

| 国 MonkeySourceNetworkjava 

国 MonkeySourceNetworkwars,java 


| : -时 data 
| 晶 docs 
| bj 别 host 国 MonkeySourceRandom,java 
| “ 击 ide 国 MonkeySourceRandomscriptjava 
直 国 ndk 
由 国 pdk 
: “出 samples 
9 出 scripts 


国 MonkeySourceScriptjava 
国 MonkeyThrottleEvent,java 
国 MoenkeyUtilsjava 

国 MonkeywwaitEvent,java 


图 4-12 ”Monkey 源 码 文件 列表 


Monkey 的 代码 框架 如 图 4-13 所 示 。 


Monkey 的 代码 核心 模块 主要 包括 主 控 、 监 控 、 事 件 源 和 事件 四 大 


ps 


区 


- 主 控 模 块 : 主 欣 模 块 即 Monkey 类 ， 是 入 口 函数 所 在 类 ， 主 要 负责 
参数 解析 和 赋值 、 初 始 化 运行 环境 〈 导 入 package 列 表 、 检 查 内 部 配 
置 、 申 请 系统 资源 、 初 始 化 事件 源 、 启 动 监控 等 ) 、 执 行 
runMonkeyCycles () 方法 针对 不 同 的 事件 源 开 始 获取 并 执行 不 同 的 事 
Fs 


监控 模块 ， 监 探 部 分 包括 异常 监控 和 网 络 监控 两 部 分 。 异 常 监控 
通过 ActivityWatch 类 来 实现 ， 主 要 监控 Activity 的 Crash 和 ANR 事 件 。 网 
络 监控 通过 MonkeyNetworkMonitor 类 来 实现 ， 主 要 用 于 统计 运行 期 间 
移动 网 络 和 Wi-Fi 网 络 的 链接 时 长 。 


事件 源 模 块 : 事件 源 代 表 不 同 的 事件 来 源 。 以 MonkeyEventSource 
为 基 类 ， 衍 生出 三 个 Source 类 ， 分 别 代表 网 络 来 源 (如 
Monkeyrunner) 、 随 机 事件 来 源 (常规 Monkey 命 令 ) 、 脚 本 来 源 ( 通 
过 -f 参 数 指定 的 脚本 ) 三 种 事件 来 源 。 事 件 源 要 做 的 事情 有 : 从 对 应 来 
源 获 取信 息 ， 并 生成 对 应 的 事件 ， 将 其 插入 事件 队列 中 。 


事件 模块 ， 事件 代表 了 各 种 用 户 操作 类 型 。 以 MonkeyEvent 为 基 
类 ， 衍 生出 各 种 Event 类 ， 每 一 个 Event 类 代表 一 种 用 户 操作 类 型 ， 如 党 
见 的 点 击 、 输 入 、 滑 动 事 件 等 。MonkeyEvent 抽 象 类 中 提供 了 
intinjectEvent () 方法 ， 用 于 执行 对 应 的 事件 。 


事件 源 模块 


I = 


: MonkeySourceScript MonkeyEventSource 
| _Fm 下 


八 


监控 模块 


ActivityWatcher 


appCrashed() 
+apnpNotResponding © 


prep 


NMonkeyNetworkMonitor |: 
+performReceive() : 


| 
trunMonkeyCycles() 


1 


+injectEvent () 
* tgetEventTyne ©O 


t+isThrottlablel) 


addLast 人 
tgetFirst () 
+removeFirst() 


事件 模块 


: ActivityEvent MotionEvent FlipEvent ThrottleEvent 
| | | | | | 
| 


: NoopEvent PowerEvent TrackballEvent RotationEvent 


OommendBvent 


图 4-13 ”Monkey 的 代码 框架 


4.3.2 Monkey 代码 逻辑 详解 


接 下 来 看 一 下 Monkey 运 行 的 流程 。 


首先 ， 从 入 口 函 数 入 手 ，Monkeyjava 的 main 方 法 如 代码 清单 4-9 所 


人 小? 


代码 清单 4-9 Monkeyjava 的 main 方 法 


public static void main(String[] args) { 
# 将 进程 名 记 入 进程 列表 


Process.setArgVo("com.android.commands .monkey"); 
# 运 行 
Monkey 


int resultCode = (new Monkey()).run(args); 
# 退 出 


System.exit(resultCode); 
} 


从 代码 中 可 以 看 到 main 方 法 是 通过 调用 run 方 法 来 运行 Monkey 
的 。Monkey.java 的 run 方 法 核心 处 理 代码 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 ”Monkey.java 的 run 方 法 核心 处 理 代码 


/ /解析 


Monkey 参 数 并 逐一 赋值 


if (!processOptions()) { 
return -1; 


// 获 取 
ActivityManager、 
WindowManager、 


PackageManager 三 大 系统 资源 


/ /通过 


ActivityManager 调 


setActivityController( ) 方 法 对 测试 4 


如 


周期 进行 监控 


二 


/ /通过 


件 注 入 到 应 用 中 ， 实 现 事 件 操作 


WindowManage 的 方法 来 将 事 


/ /通过 


PackageManager 获 取 


INtent 中 应 用 列表 ， 方便 在 多 应 用 之 间 切 换 


if (!getSystemInterfaces()) { 
return -3; 
} 


/ /初始化 事件 源 


/ /脚本 事件 源 : 带 


- 千 参 数 且 脚本 数 等 于 


工 

if (mScriptFileNames != null && mScriptFileNames.size() == 1) { 
mEventSource = new MonkeySourceScript(mRandom, mScriptFileNames.get(0), 

mThrottle, mRandomizeThrottle, mprofilewaitTime, mDeviceSleepTime); 
mEventSource.setVerbose(mVerbose); 
mCountEvents = false; 

/ /脚本 事件 源 


rt 


-下 参数 且 肢 本数 大 于 


1 
} else if (mScriptFileNames != null && mScriptFileNames.size() > 1) { 
if (mSetupFileName != null) { 
mEventSource = new MonkeySourceRandomScript(mSetupFileName, 
mSscriptFileNames, mThrottle, mRandomizeThrottle, mRandom, 
mpProfilewaitTime, mDeviceSleepTime, mRandomizeScript); 
mCount++; 


} else { 
mEventSource = new MonkeySourceRandomScript(mScriptFileNames, 
mThrottle, mRandomizeThrottle, mRandom, 
mpProfiJewaitTime, mDeviceSleepTime, mRandomizeScript); 


mEventSource.setVerbose(mVerbose); 
mCountEvents = false; 
/ /远程 调用 事件 源 : 带 


- -Port 参数 


} else if (mServerPort != -1) { 


try { 
mEventSource = new MonkeySourceNetwork(mServerPort); 


} catch (IOException e) { 
System.out.println("Error binding to network socket."); 
return -5; 
} 
mCount = Integer .MAX_VALUE,; 
/ /随机 事件 源 


} else { 
// random source by default 
if (mVerbose >= 2) { // check seeding performance 
System,out,println("// Seeded: " + mSeed); 
} 


mEventSource = new MonkeySourceRandom(mRandom, mMainApps, mThrottle, 
mRandomizeThrottle); 
mEventSource.setVerbose(mVerbose); 
// set any of the factors that has been set 
for (int i = 0; i < MonkeySourceRandom,FACTORZ_COUNT， i++) { 
If (mFactors[i] <= 0.0f) { 
((MonkeySourceRandom) mEventSource).setFactors(i, mFactors[i]); 
} 


// in random mode, we start with a random activity 
((MonkeySourceRandom) mEventSource).generateActivity(); 


/ /启动 网 络 监控 程序 

mNetworkMonitor.start(); 

/ /开始 执行 

Monkey 

int crashedAtCycle = runMonkeyCycles(); 
mNetworkMonitor.stop(); 

// 打 印 

ANR、 


Crash 等 报告 


Synchronized (this) { 


从 代码 解析 可 以 看 到 ，run 方 法 主要 做 了 以 下 几 件 事 。 
.参数 解析 和 参数 赋值 。 

:申请 系统 资源 。 

.初始 化 事件 源 。 

启动 网 络 监控 程序 。 

:调用 runMonkeyCycles 方 法 执行 Monkey 。 


再 来 看 一 下 runMonkeyCycles 方 法 又 做 了 什么 。runMonkeyCycles 
中 最 核心 的 逻辑 如 代码 清单 4-11 所 示 。 


代码 清单 4-11 runMonkeyCydles 方 法 核心 代码 


while (!systemCrashed && cycleCounter < mCount) { 


/ /通过 不 同事 件 源 读 取 下 一 事件 


getNextEvent() 
MonkeyEvent ev = mEventSource.getNextEvent(); 
If (ev != null) { 
// 通 过 


injectEvent( ) 将 事件 注入 系统 中 


int injectCode = ev.injectEvent (mwm, mAm, mVerbose); 


从 代码 分 析 可 知 ，runMonkeyCycles 做 了 两 件 事 ， 一 是 调用 了 事件 
源 的 getNextEvent 方 法 读 取 下 一 个 事件 ， 二 是 调用 事件 的 injectEvent 方 
法 执行 该 事件 。 


针对 不 同 的 事件 源 ，getNextEvent 方 法 的 具体 实现 是 不 同 的 ， 不 过 
它们 的 目的 都 具有 一 个 ， 即 获取 下 一 个 事件 。 以 随机 事件 源 
(monkeySourceRandom) 为 例 ， 来 看 一 下 它 是 怎么 实现 getNextEvent 
的 ， 如 代码 清单 4-12 所 示 。 


代码 清单 4-12 ”getNextEvent 方 法 核心 代码 


public MonkeyEvent getNextEvent() { 
//mQ 表 示 事件 队 列 


// 在 


monkeySourceRandom 初 始 化 时 会 创建 一 个 事件 队列 用 于 存放 被 执行 事 


本 


/ /假如 当前 事件 队列 为 空 ， 则 创建 事件 并 加 入 队列 中 


if (mQ.isEmpty()) { 
generateEvents(); 


} 
// 获 取 当 前 队列 中 的 第 一 个 事件 


mEventCount++; 
MonkeyEvent e = getrFirst(); 
// 从 队列 中 删除 被 取出 的 事 


mQ.removeFirst(); 
return e; 


monkeySourceRandom 在 初始 化 的 时 候 会 创建 一 个 事件 队列 mQ 用 
于 存放 Monkey 事 件 。 当 外 部 调用 getNextEvent 方 法 时 ， 会 先 去 判断 mQ 
队列 中 是 否 有 事件 ， 如 采 队 列 中 没有 事件 ， 则 调用 generateEvents 方 
法 ， 根 据 事件 源 目 喘 的 规则 生成 事件 流 ， 并 将 其 存放 到 mQ 队 列 中 ;如 
果 队 列 中 有 事件 ， 则 会 取出 第 一 个 事件 返回 ， 并 同时 从 队列 中 删除 该 
本 下 


而 获取 事件 后 需要 做 的 就 是 执行 相应 的 事件 ， 也 就 是 将 事件 通 
injectEvent 方 法 逐一 注入 系统 中 。 几 乎 每 个 Event 事 件 都 有 对 injectEvent 
方法 的 具体 实现 。 这 里 以 触摸 事件 (MonkeyTouchEvent) 为 例 来 看 一 
下 它 是 如 何 进行 事件 注入 的 ， 如 代码 清单 4-13 所 示 。 


代码 清单 4-13 ”MonkeyTouchEvent 代 码 注 入 实现 


public int injectEvent(IWindowManager iwm, IActivityManager iam, int verbose) { 
String note,; 
// 输 出 事件 执行 日 志 


If ((verbose > 0 && !mIntermediateNote) || verbose > 1) { 
if (mAction == MotionEvent.ACTION_DOWwN) { 
note = "DOWN"; 
} else if (mAction == MotionEvent.ACTION_UP) { 
note = "UP"; 
} else { 
note = "MOVE",; 


} 
System.out.println(":Sending Pointer ACTION_" + note + 
mh > dd mX i Ld y=" 旨 mY ); 


try { 
/ /获取 当前 事件 及 其 类 型 


int type = this.getEventType(); 
MotionEvent me = getEvent(); 
// 调 


WindowManager 的 方法 实现 事件 注入 


// 如 果 是 


Point 类 型 ， 调 


injectPointerEvent 接 口 


// 如 果 是 


Trackbal1 类 型 ， 调 


injectTrackballEvent 接 口 


If ((type == MonkeyEvent.EVENT_TYPE_POINTER && 
!iwm.injectPointerEvent(me, false)) 
|| (type == MonkeyEvent .EVENT_TYPE_TRACKBALL && 
!iwm.injectTrackballEvent(me, false))) { 
return MonkeyEvent.INJECT_FAIL; 


} catch (RemoteException ex) 
return MonkeyEvent.INJECT_ERROR_REMOTE_EXCEPTION; 


} 
return MonkeyEvent ,INJECT_SUCCESS ; 
} 


这 里 ， 执 行事 件 通 过 调用 WindowManager 的 接口 来 实现 事件 注 


最 后 来 回顾 一 下 整个 Monkey 事 件 执行 的 流程 。 
(1) 初始 化 事件 源 ， 创 建 事件 队列 。 
(2) 通过 getNextEvent () 方法 循环 获取 事件 。 


(3) 通过 injectEvent 方 法 调用 windowManager 的 方法 将 事件 注入 
分 统 充 中 。 


4.4 _ Monkey 扩展 应 用 示例 


前 面 讲 到 了 Monkey 的 基本 使 用 方法 及 其 原理 ， 可 以 看 到 Monkey 
功能 还 是 很 强大 的 ， 它 不 但 可 以 进行 随机 测试 ， 还 可 以 执行 指定 脚 
本 ， 结 合 adb 命 令 还 可 以 监控 各 种 性 能 数据 。 但 它 毕 葛 是 一 款 为 稳定 性 
测试 而 准备 的 小 工具 ， 所 以 存在 很 多 局 限 性 ， 正 如 前 面 Monkey 实 践 一 
中 提 到 的 ，Monkey 不 提供 截屏 功能 ， 因 此 测试 很 难 找到 问题 复 现 的 
场景 ;Monkey 无 法 进行 控件 识别 ， 对 事件 流 控 制 能 力 很 微弱 ， 执 行 过 
程 中 容易 误 点 工具 栏 导致 Wi-Fi 关 闭 ， 影 响 测试 效 末 ;等 等 。 本 节 重 点 
介绍 的 惑 是 如 何 通过 Monkey 源 码 改造 的 方法 来 解决 上 述 问 题 ， 以 更 好 
地 提升 Monkey 的 使 用 效果 。 


@ 注意 随 书 提供 的 源码 是 Windows 系 统 下 可 运行 的 Monkey 工 
程 ， 仅 适用 于 Android 4.1.2 版 本 的 手机 。 


要 改造 Monkey， 束 要 先 了 解 如 何 重 编译 Monkey 。 


4.4.1 _ Monkey 代码 重 编译 执行 方法 


Monkey 重 编译 的 方法 有 两 种 ， 一 种 是 在 Linux 环 境 下 编译 ， 男 一 种 
是 在 Windows 环 境 下 编译 。 因 为 在 windows 环 境 下 编译 更 为 常见 ， 所 以 
这 里 会 重点 介绍 第 二 种 方法 。 


1.Linux 环 境 下 编译 


在 Linux 环 境 下 ， 下 载 要 测试 Android 系 统 版 本 对 应 的 全 部 源 代 码 ， 
进入 源码 目 永 。 


步骤 1: 执行 .build/envsetup.sh， 设 置 Android 的 编译 环境 。 
步骤 2: 执行 make monkey 开 始 编译 Monkey 。 


编译 成 功 后 ， 可 在 /out/target/product/generic/system/framework/ 中 获 
取 Monkey.jar 包 。 


2.Windows 环 境 下 编译 


Windows 环 境 下 的 编译 要 稍微 复杂 一 点。 


步骤 1: 创建 Monkey 项 目 。 同 样 也 是 需要 下 载 要 测试 Android 系 统 
版 本 对 应 的 全 部 源 代码 ， 在 /development/cmds/monkey 目 录 下 找到 


Monkey 的 工程 源码 。 在 Eclipse 中 新 建 一 个 Java 工 程 ， 把 Monkey 源 码 导 
代 进 去 ” 


步骤 2: 设置 Java Build Path 。 选 中 对 应 项 目 ， 在 顶部 染 单 栏 依次 
选 题 Project 一 Properties ~ Jave Build Path »Libraries， 深 加 两 个 jar 艾 件 : 
android.jar 和 framework.jar。 其 中 android.jar 可 以 从 Android Sdk 中 
platforms\android-X\ 目 录 下 获取 ; framework.jar 可 以 通过 以 下 两 种 方式 
获取 。 


(1) (推荐 从 在 Linux 环 境 下 Android 源 码 根 目录 执行 make 
update-api 编 译 生成 ， 如 截图 中 的 classes_dex2jar.jar 文 件 就 是 通过 
Android 源 码 编译 生成 的 。 


(2) 直接 从 Android 手 机 上 /systenyframework 目 录 下 获取 已 经 编译 
好 的 framework.jar 文 件 ， 把 这 个 framework.jar 解 压 ， 取 出 其 dex， 然 后 把 
它 的 dex 通 过 dex2jar 工 具 转 换 为 jar 包 ， 导 入 工程 。 


添加 android 和 framework 的 jar 包 后 ， 还 需要 将 framework 的 jar 包 顺 
序 调整 到 顶部 ， 如 图 4-14 所 示 。 


ltype fiter text | Java Build Path 


>» Resource - - 
dre 下 Source | BE Projects | BB Libraries | %; Order and Export 


Android Lint Preferences JARs and class folders on the build path: 


Builders P 加 classes_dex2jarjar - Monkeyd.1.2_baklibs| Add JARs,.. 
Java Build Path 


4 到 Androld 4.1.2 


> Java Code Style 记 Access rules: No rules defined Add External JARs... 
» Java Compiler i Native library location: (None) a 
> Java Editor 加 mn p = 


bp le android,ar - D:\Program Files\android-sdk-wir 


Javadoc Location 》 Dependences Add Library... 
Project References 4 Bi Android Private Libraries Add Cloce Fold 

ass Folder... 
Refactoring History 包 Access rules: No rules defined 一 


RunyDebug Settings BB Native library location: (None) Add External Class Folder,... 
Task Tags 


» a rtjar - DAUsers\sharonzheng\workspace\vionl 


> Validation > classes,jar - DAUsers\sharonzheng\workspace’ Edit... 


classes_dex2jar,ar - DAN\Users\sharonzheng\wo 


品 android-support-vd.ar - DAUsersvsharonzhentk 
Migrate JAR File... 


图 4-14 ”添加 android 和 framework 的 jar 包 


步骤 3: 编译 生成 jar 包 。 选 择 Monkey 项 目 ， 单 击 右键 ~ 单 击 
Export 一 选择 输出 的 Jar 包 类 型 为 “JAR file” 类 ， 单 击 *Next" 按 钮 ， 如 图 4- 
15 所 示 。 


选择 对 应 的 构建 工程 ， 填 写 jar 包 输出 路 径 ， 单 击 “Next” 按 钮 ， 如 
图 4-16 所 示 。 


进入 打包 选项 页 面 ， 这 里 用 默认 选项 即 可 ， 直 接 单 击 *Next" 按 钮 ， 
如 图 4-17 所 示 。 


选择 工程 中 main 函 数 所 在 的 类 ， 单 击 “Finish” 按 钮 ， 如 图 4-18 所 


人 小， 


编译 完成 后 ， 在 指定 目录 下 就 会 生成 对 应 的 Monkey.jar 包 了 。 


Select 


Export resources Into a JAR file on the local file system。 


Select an export destination: 


ltype filter text 


司 preferences 
>» 车 Android 
b> GB C/C++ 
>» EE Install 
4 ( Java 


加] Javadoc 

. Runnable JAR file 
» EE Plug-in Development 
>» EE Run/Debug 
b» EE Team 
> 铭 - XML 


图 4-15 ”选择 JAR file 


JAR File Specification 
Define which resources should be exported into the JAR. 


Select the resources to export: 


人 NobileAccelerateAdivity 四 .classpath 

证 Monkey4.12 for tita 加 四 .projedt 

贺 可 Monkey4.2 园 BD AndroidIManifestxml 
胆 PluginReet 园 目 proguard-project.txt 
同 代 super_diff 

谍 SvNKitTest 

全 TencentIvlobileAssistent6.0 
回国 wifiTransferActivity 


贺 国 prejscLproeperties 


Expor generated classfiles and respurces 
Export all output folders for checked projects 
Export Java source files and resources 


加 Export refactorings for checked projects. Select refacorings... 


Select the expPort destinatian: 
JAR fle: 23Program Filesyandroid-sdk-windows_4.0\platform-tools\Nonkey,jar | | 人 Browse 


OQptions: 
FICompress the contents of the JAR file 
[VAdd directory entries 


园 @vermrite existing files without warning 


® 


图 4-16 ”填写 jar 包 输出 路 径 


JAR Packaging 口 Ftions 
Define the options for the JAR export. 


Select options for handling problems: 
[VExport class files with compile errors 
Export class files with compile warnings 


[|Create source folder structure 


Build projects ff not built suternatically 


FSave the description of this JAR in the workspace 


图 4-17 打包 选项 页 面 


JAR Manifest Specification 


Customize the manifest file for the JAR file. 


Specify the manifest: 
© Generate the manifest file 


Save the manifest in the workspace 


[| Use the saved manifest in the generated JAR description file 


Manitest file: /clearNumTool/MANIFEST.MEF | | Browse... | 


加 Use exlsting manifest from workspace 


Manifest file: [fclearNumTool/MANIFEST.NME || Browse.: | 


Seal contents: 


SS Seal the JR 


| Details.. | 


Seal some packages Nothing sealed 


Select the class of the application entry point: 


Main class: corm.android.debug.monkey.Nlonkey 


图 4-18 ”选择 main 函 数 所 在 的 类 


步骤 4:， 转换 Monkey.jar 包 。Eclipse 编 译 出 来 的 jar 包 是 不 能 直接 放 
到 Android 手 机 上 运行 的 ， 在 Android 上 无 法 像 Java 中 那样 方便 地 动态 加 


载 jar。 原 因 是 : Android 的 虚拟 机 (Dalvik VM) 是 不 能 识别 Java 打 出 的 
jar 的 byte code 的 ， 这 里 需要 通过 Android sdk 中 的 dx 工具 来 优化 转换 成 


Dalvik byte code 才 行 。 


将 打包 好 的 jar 复 制 到 SDK 安 闭 目 孙 android-sdk-windows\platform- 
tools 下 ， 打 开 命 令 行 进入 platform-tools 目 未 ， 执 行 命令 


dx --dex --output=< 生 成 的 目标 文件 
> < 要 转换 的 文件 


> 


执行 方法 如 图 4-19 所 示 


图 4-19 ”转化 Monkey.jar 包 执行 方法 


此 时 在 android-sdk-windows\platform-tools 目 录 下 会 生成 最 终 的 
Monkey 可 执行 包 ， 这 个 jar 包 可 直接 在 手机 上 运行 。 这 里 输出 的 是 


Monkeytest.jar。 
3. 重 编译 的 包 运 行 方法 


假设 前 面 重 编译 后 生成 的 Monkey 文 件 为 Monkey.jar 文 件 ， 测 试 如 
何在 手机 上 执行 这 个 新 文件 呢 ? 


要 运行 重 编 译 后 的 Monkey.jar 有 以 下 两 个 前 提 条 件 。 
:手机 拥有 root 权 限 。 


手机 Android 有 版 本 与 Monkey.jar 包 的 Android 版 本 一 致 。 


(由 于 不 同 版 本 的 Android 系 统 API 不 同 ， 因 此 不 同 版 本 的 Monkey 
包 也 是 不 能 通用 的 。 例 如 : Android 4.2 版 本 的 Monkey 只 能 在 Android 


步骤 1: 创建 启动 shell 脚 本 。 


在 本 地 新 建 一 个 用 于 启动 Monkey 的 shell 脚 本 ， 输 入 以 下 命令 ,并 
保存 成 Monkey。 这 个 文件 是 用 来 启动 和 执行 Monkeyjar 的 ， 如 下 面 的 
代码 所 示 。 


# Script to start "monkeytest" on the device, which has a very rudimentary 
# shell. 
# 这 里 要 填写 编译 后 生成 的 


jar 文件 名 称 


export CLASSPATH=/data/ Monkey .jar 
# 这 里 要 填写 


jar 文件 中 的 入 口 画 数 所 在 类 


exec app_process /data com.android.debug.monkey.Monkey $* 


步骤 2: 上 传 脚本 和 jar 包 到 手机 。 


将 步骤 1 创建 的 Monkey 脚 本 和 Monkey.jar 包 上 传 到 手机 的 /data/loal 
目录 〈 可 自己 定义 ， 与 shell 脚 本 中 的 目录 一 致 即 可 ) ， 并 将 Monkey 文 
件 修改 成 可 执行 权限 ， 如 下 面 代 码 所 示 。 


adb push Monkey.jar /data 
adb push monkey /data 
adb shell chmod777 /data/monkey 


个 别 手机 上 执行 chmod 命 令 时 会 报 Segmentation Fault 错 误 ， 这 时 可 
以 先 adb shell 进 入 ， 通 过 sw root 命 令 切换 到 root 下 ， 再 执行 chrnod 
777/data/monkey 即 可 。 


步骤 3: 运行 monkey。 


sy 


通过 命令 行 窗 口 ， 输 入 adb shell./data/local/monkey<option>[count] 


命令 启动 Monkey.jar 包 即 可 运行 Monkey。 


4.4.2 ” ”Monkey 截图 优化 


掌握 重 编译 Monkey 的 方法 后 ， 接 下 来 要 开始 进行 Monkey 源 码 改造 
了 。 第 一 个 改造 就 是 截图 改造 。Monkey 使 用 过 程 中 最 大 的 难题 就 是 如 
何 获 取 异 常 出 现 的 场景 。 虽 然 Monkey 在 执行 过 程 中 提供 了 日 志 来 记录 
事件 执行 顺序 ， 但 是 光 靠 日 志 来 定位 异常 出 现 的 场景 并 复 现 它 是 非常 
困难 的 。 当 Monkey 执 行 过 程 中 出 现 异常 时 ， 大 可 以 对 应 进行 截图 并 记 
孙 异 稼 出 现 前 执行 的 操作 ， 就 可 以 清晰 地 知道 异常 出 现 的 场景 ， 也 便 
于 定位 和 解决 问题 。 


具体 改造 方法 如 下 : 


测试 期 望 实现 的 是 在 每 个 事件 执行 过 程 中 增加 截图 并 在 图 片上 画 
出 事件 轨迹 。 这 里 以 屏幕 触摸 操作 为 例 ， 首 先 找到 触摸 事件 所 在 的 文 
件 MonkeyMotionEvent.java， 找 到 负责 执行 该 事件 的 injectMotionEvent 
方法 。 先 来 看 一 下 它 的 实现 ， 如 代码 清单 4-14 所 示 。 


代码 清单 4-14 ”injectMonkeyEvent 方 法 源 代 码 


public int injectEvent(IWindowManager iwm, IActivityManager iam, int verbose) { 
String note,; 
if ((verbose > 0 && !mIntermediateNote) || verbose > 1) { 
if (mAction == MotionEvent.ACTION_ DOWN) { 
note = "DOWN"; 
} else if (mAction == MotionEvent.ACTION UP) { 
note = "UP"; 
} else { 
note = "MOVE"; 
} 


System.out,.println(":Sending Pointer ACTION " + note + 
mh 三 十 mxX 让 mh y=" 中 mY); 


} 
try { 
int type = this.getEventType(); 
MotionEvent me = getEvent(); 
If ((type == MonkeyEvent ,EVENT_TYPE_POINTER && 
!iwm.injectPointerEvent(me, false)) 
|| (type == MonkeyEvent .EVENT_TYPE_TRACKBALL &&. 
!iwm.injectTrackballEvent(me, false))) { 
return MonkeyEvent .INJECT_FAIL， 


} catch (RemoteException ex) 
return MonkeyEvent.INJECT_ERROR_REMOTE_EXCEPTION; 


} 
return MonkeyEvent.INJECT_SUCCESS,; 


这 里 是 通过 WindowManager 的 一 个 实例 访问 InjectPointerEvent 和 
injectIrackballEvent 接 口 来 实现 事件 注入 的 。 其 中 me 参数 表示 要 执行 的 
一 个 MotionEvent 事 件 。 常 规 的 触摸 操作 是 由 三 类 MotionEvent 事 件 组 成 
的 ， 一 类 是 ACTION_DOWN 类 型 的 MotionEvent， 表 示 按 下 ; 一 类 是 
ACTION_MOVE 类 型 的 MotionEvent， 表 示 移 动 ; 一 类 是 ACTION_UP 
事件 ， 表 示 抬 起 。ACTION_DOWN 是 每 个 点 击 事件 的 开始 ， 只 要 在 这 
个 地 方 添加 一 个 截图 方法 ， 即 可 对 点 击 事件 进行 截图 。 


除了 截图 以 外 ， 还 需要 记录 事件 轨迹 。 因 此 在 每 个 事件 中 ， 
把 点 坐标 记录 下 来 ， 存 放 到 一 个 PointList 的 点 队列 中 。 当 出 现 
ACTION_UP 时 ， 意 味 着 整个 点 击 操作 已 经 完成 了 ， 此 时 把 最 后 一 个 点 
坐标 加 到 队列 后 ， 再 把 队列 中 保存 的 所 有 点 坐标 按 一 定 的 规则 画 到 开 
始 时 截 的 图 中 ， 压 缩 图 片 并 保存 ， 此 时 就 完成 了 一 个 点 击 操作 的 截图 
和 记录 。 最 后 别 饼 了 清空 PointList 队 列 。 


修改 后 的 injectEvent 方 法 如 代码 清单 4-15 所 示 。 


代码 清单 4-15 ”在 injectEvent 方 法 中 增加 截图 和 男 轨 迹 


public int injectEvent(IWindowManager iwm, IActivityManager iam, int verbose) { 
String note,; 
if ((verbose > 0 && !mIntermediateNote) || verbose > 1) { 
if (mAction == MotionEvent.ACTION_ DOWN) { 
note = "DOWN"; 
// 截 图 


ImageUtils.TakeScreenshot(); 
/ /获取 当前 点 击 坐标 ， 存 到 队列 中 


ImageUtils.addPoint(me.getXx(),me.getY()); 
} else if (mAction == MotionEvent.ACTION UP) { 

note = "UP"; 

/ /获取 当前 点 击 坐标 ， 存 到 队列 中 


ImageUtils.addPoint(me.getX(),me.getY())， 
/ /把 队列 中 的 点 击 坐标 画 到 图 片上 


Bitmap bc=ImageUtils,.drawPoint(ImageUtils.scaleBitmap()); 
ImageUtils.removePointList();// 清 空 队 列 


} else { 
note = "MOVE"; 
/ /获取 当 前 点 击 坐 标 ， 存 到 队列 中 


ImageUtils.addPoint(me.getXx(),me.getY()); 


} 
System.out.println(":Sending Pointer ACTION " + note + 
mh Wr 可 mxX 站 中 y=" 下 mY); 


上 面 用 到 的 截图 方法 TakeScreenshot 是 直接 调用 一 个 第 三 方 的 截屏 
工具 gsnapCap 进 行 截 屏 的 ， 有 具体 实现 如 代码 清单 4-16 所 示 。 


代码 清单 4-16 ”截图 方法 的 实现 


public static void TakeScreenshot() { 
/ /以 时 间 戳 命名 截图 文件 


String filename=String.valueof(System.currentTimeMillis()); 


/ /通过 命令 行 调用 了 


gsnapCap 工 具 进行 截图 


Process p = Runtime.getRuntime().exec("/data/local/gsnapCap 
"+filepath+filename+".jpg /dev/graphics/fbQO 1"); 
p.waitFor(); 
/ /异常 处 理 


} catch (IOException e) { 

System.out.println("cannot write picture,please check your gsnapCap"); 
} catch (InterruptedException e) { 

System.out.printin("cannot write picture,please check your gsnapCap"); 
} 


前 面 在 injectEvent 方 法 中 调用 了 一 个 drawPoint 方 法 将 操作 轨迹 画 到 
图 片上 ，drawPoint 方 法 具体 实现 如 代码 清单 4-17 所 示 。 


代码 清单 4-17 ” 画 操 作 轨 迹 方 法 的 实现 


public static Bitmap drawPoint(Bitmap src) { 
/ /判断 传 入 的 


Bitmap 图 片 文 件 是 否 为 空 


If (src == null) { 
return null; 
} 


int w = src.getwidth(); 
int h = src.getHeight(); 
/ /创建 一 个 新 的 和 


SRC 长 度 宽度 一 样 的 位 图 


Bitmap newb= Bitmap.createBitmap(w, h, Config.ARGB_ 8888); 
Canvas cv = new Canvas(newb ) ， 

cv.drawBitmap(src, 0, 0, null); 

MyCanvas mycanvas=new MyCanvas(); 
mycanvas.setpaintDefaultstyle(); 


mycanvas .onDraw(cVv) 
/ /获取 起 始 位 置 和 结束 位 置 的 点 


Point to=(Point) PointList.get(PointList.size()-1); 
Point from=(Point) PointList.get(0); 
// 只 有 两 个 点 ， 直 接 在 图 片上 画 点 及 点 击 坐 标 


If(PointList,Size()<3){ 
mycanvas .drawText("o 


", (int)to.getX()-10，(int)to.getY()+10)， 
mycanvas.drawText("Click ("+(Iint)to.getX()+"，"+(int)to,getY()+")"， 
(int)to.getX()-100, (int)to.getY()-15); 
// 有 多 个 点 ， 则 画 箭头 并 标注 操作 坐标 


/ /为 避免 文字 超出 图 片 范围 ， 所 以 要 根据 起 始点 和 终点 的 位 置 来 调整 文字 展示 位 置 


}else if((int)from.getY()<(int)to.getY()&&(int)from.getX()>w/X2){ 
mycanvas.drawAL( (int)from.getx(), (int)from.getY(), (int)to.getXx(), 
(int)to.getyY());; 
mycanvas.drawText("From ("+(int)from.getX()+","+(int)from.getY()+")", 
(int)from.getX()-100, (int)from.getY()-15); 
mycanvas.drawText("To ("+(int)to.getXx()+","+(int)to.getY()+")", 
(int)to.getXx()-100, (int)to.getY()+30); 
}else if((int)from.getY()>(int)to.getY()&&(int)from.getX()>w/2)t{ 
mycanvas.drawAL( (int)from.getxX(), (int)from.getY(), (int)to.getx(), 
(int)to.getyY());; 
mycanvas.drawText("From ("+(int)from.getxXx()+","+(int)from.getY()+")", 
(int)from.getX()-100, (int)from.getY()+30); 
mycanvas.drawText("To ("+(int)to.getX()+","+(int)to.getY()+")", 
(int)to.getXx()-100, (int)to.getY()-15); 
}else if((int)from.getY()<(int)to.getY()&&(int)from.getX()<=w/2){ 
mycanvas.drawAL( (int)from.getx(), (int)from.getY(), (int)to.getXx(), 
(int)to.getyY());; 
mycanvas.drawText("From ("+(int)from.getx()+","+(int)from.getY()+")", 
(int)from.getX()-50, (int)from.getY()-15); 
mycanvas.drawText("To ("+(int)to.getXx()+","+(int)to.getyY()+")", 
(int)to.getxX()-50, (int)to.getY()+30); 
}else if((int)from.getY()>(int)to.getY()&&(int)from.getX()<=w/2){ 
mycanvas.drawAL( (int)from.getxX(), (int)from.getY(), (int)to.getx(), 
(int)to.getyY());; 
mycanvas.drawText("From ("+(int)from.getXx()+","+(int)from.getY()+")", 
(int)from.getX()-50, (int)from.getY()+30); 
mycanvas.drawText("To ("+(int)to.getX()+","+(int)to.getY()+")", 
(int)to.getxX()-50, (int)to.getY()-15); 
} 


/ /保存 ， 描 点 完成 


cv=mycanvas .getCanvas(); 
cv.save(Canvas.ALL_ SAVE_FLAG); 
cv.restore(); 

return newb ; 


参照 上 面 的 修改 思路 ， 将 Monkey 的 其 他 方法 也 进行 类 似 的 修改 。 
这 样 ，Monkey 每 执行 一 个 操作 ， 系 统 就 会 目 动 对 其 进行 截图 描 点 了 。 


由 于 手机 SD 卡 空间 有 限 ， 如 采 不 断 地 往 手 机 里 添加 文件 ，SD 卡 很 
快 束 会 被 填 满 。 因 此 还 需要 增加 一 个 定时 清理 的 操作 ， 即 只 保存 最 新 
的 30 张 图 片 ， 一 旦 图 片 超过 30 张 ， 束 会 把 最 早 的 一 张 图 片 删 除 。 删 除 
的 实现 方法 如 代码 清单 4-18 所 示 ， 只 需要 在 每 次 创建 图 片 时 ， 调 用 这 个 
方法 即 可 。 


代码 清单 4-18 删除 SD 卡 文件 方法 的 实现 


public static void deletefile(){ 
File files = new File(filepath ) ， 
File filelist[] = files.]1listFiles(); 
File file =null; 
long time=0， 
if(filelist==null){ 
return; 


} 
if(filelist.length>30)f{ 
for (int i=0;i<filelist.length;i++){ 
String tempname=filelist[i].getName(); 
tempname=tempname. substring(0, tempname.1lastIndexOof("'."')); 
long temptime= Long.valueof(tempname); 
if(temptime<time| |time==0){ 
time=temptime,; 
file=filelist[i]; 
} 
} 
file.delete( ); 


} 
} 


前 面 做 了 这 么 多 ， 最 终 当 然 是 希望 被 测 程序 在 跑 Monkey 出 现 
Crash、ANR 时 ， 把 截图 保存 下 来 。 因 此 需要 在 程序 中 加 入 下 面 这 几 行 
代码 ， 当 出 现 Crash 等 异常 时 ， 会 将 最 新 的 30 张 截图 复制 下 来 ， 存 放 到 


一 个 以 “Crash+ 当 前 时 间 差 ”命名 的 文件 夹 中 ， 具 体 实现 如 代码 清单 4-19 
所 示 。 


代码 清单 4-19 ”Crash 和 ANR 时 保持 截图 的 实现 


private void reportAnrTraces() { 
try { 
Thread.sleep(5 * 1000); 
} catch (InterruptedException e) { 


commandLineReport("anr traces", "cat /data/anr/traces.txt"); 
// 把 截图 复制 过 去 


ImageUtils.TakeScreenshot(); 


FileOperate.copyFolder (StorageDirectory+"/Monkey/Pic",StorageDirectory+"/Monkey/AN 
R/ANR"+String.valueOof(System.currentTimeMillis())); 
和 


这 样 Monkey 截 图 功能 就 完成 了 ， 来 看 一 下 执行 的 效果 。 当 手机 执 
行 完 Monkey 后 ， 假 如 执行 过 程 中 出 现 了 Crash 或 ANR， 那 么 在 sdcard 的 
Monkey 目 录 下 会 对 应 生成 Crash 和 ANR 目 录 ， 并 保存 发 送 异 常 之 前 的 30 
张 屏 幕 截图 ， 如 图 4-20 所 示 。 


PFITITEHTEST ET7TE XITTT TFTIT 


“ 谭 E 文件 管理 + Q < 文件 管理 


/storage/emulated/0/Monkey /storage/emulated/0/Monkey/Crash 一 一 一 一 ,mulated/0/Monkey/Crash/Crash1369817117366 


DD ANR 7 MM crash1369817117366 EB 1467978121008.jpg 
| Crash EB 1467978121569.jpg 
A Pic 1467978122070.jpg 
#5. 1467978122820.jpg 
zew 1467978123416.jpg 


sa 1467978123863.jpg 


EB 1467978126564jpg 


图 4-20 ”Crash 和 ANR 目 好 中 保存 的 截图 


图 片上 面 会 显示 当前 事件 的 操作 坐标 ， 如 图 4-21 所 示 。 
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图 4-21 Monkey 截 图 


4.4.3 ” Monkey Wi-Fi 自 动 重 连 优化 


我 们 知道 大 部 分 的 应 用 程序 是 需要 联网 的 ， 假 如 Monkey 在 执行 过 
程 中 Wi-Fi 断 开 了 怎么 办 ? 由 于 Monkey 执 行 的 是 随机 事件 流 ， 过 程 中 
的 操作 无 法 控制 ， 用 户 很 容易 误 点 到 工具 栏 而 导致 Wi-Fi 扬 开 。 对 于 需 
要 联网 的 应 用 ， 当 Wi-Fi 断 开 后 ， 很 多 页 面 都 会 无 法 打开 ， 此 时 
Monkey 执 行 的 效 采 会 相当 不 理想 。 相信 这 也 是 绝 大 多 数 用 户 直 到 的 问 
题 ， 当 前 小 市 介绍 的 就 是 如 何 通 过 Monkey 改 造 来 实现 Wi-Fi 汤 开 重 连 
的 功能 。 


首先 ， 靳 增 一 个 用 于 Wi-Fi 监 控 的 事件 MonkeyWifiEvent。 在 
Monkey 中 新 增 一 类 事件 有 以 下 两 个 步骤 。 


(1) 在 MonkeyEvent 新 增 一 个 eventType 类 型 ， 如 代码 清单 4-20 所 


代码 清单 4-20 ”Wi-Fi 重 连 的 EvenType 


public abstract class MonkeyEvent { 
protected int eventType; 
public static final int EVENT_TYPE_KEY = 0,; 
public static final int EVENT_TYPE_TOUCH = 1; 
public static final int EVENT_TYPE_TRACKBALL = 2; 
public static final int EVENT_TYPE_ROTATION = 3; // Screen rotation 
public static final int EVENT_TYPE_ACTIVITY = 4; 
public static final int EVENT_TYPE_FLIP = 5; 
public static final int EVENT_TYPE_THROTTLE = 6; 
public static final int EVENT_TYPE_NOOP = 7; 
## 新 增 一 个 


Wi -Fi 监控 的 事件 类 型 


public static final int EVENT_TYPE_ WifiCheck = 


(2) 新 增 对 应 事件 的 MonkeyWifiEvent 类 ， 需 继承 自 
MonkeyEvent 类 ， 如 代码 清单 4-21 所 示 。 


代码 清单 4-21 Wi-Fi 重 连 的 MonkeyEvent 类 实现 


package com.android.debug.monkey; 

import java.io.BufferedReader; 

import java.io,.File; 

import java.io.FileReader; 

import java.io.IOException; 

import android.app.IActivityManager; 

import android.view.IWindowManager; 

import com.android.debug.manager .wifiManager,; 

public class MonkeywifiEvent extends MonkeyEvent{ 
/ /初始 方法 


public MonkeywifiEvent() { 
super (MonkeyEvent .EVENT_TYPE_WifiCheck); 


} 
// 调 


CheckwifiConnection( ) 方 法 检查 


Wi -Fi 连接 


public int injectEvent(IWindowManager iwm, IActivityManager iam,int verbose){ 
System,.out,println("Check Wifi Conection."); 
wifiManager .CheckwifiConnection(); 
return MonkeyEvent.INJECT_SUCCESS,; 

} 


从 上 面 的 代码 可 以 看 到 ， 该 事件 是 通过 调用 CheckWifiConnection 
() 方法 来 检查 Wi-Fi 连 接 并 自动 重 连 的 。 


CheckWifiConnection () 方法 的 实现 很 简单 ， 首 先 初 始 化 一 个 
WifiManager 的 对 象 ， 调 用 其 getWifiEnabledState 方 法 ， 检 查 当 前 Wi-Fi 
是 否 连接 ， 当 判断 为 Wi-Fi 无 连接 时 ， 调 用 setWifiEnabled 方 法 打开 Wi- 
Fi。 等 待 Wi-Fi 打 开 后 ， 通 过 getConfiguredNetworks 方 法 获取 Wi-Fi 列 
表 ， 并 遍历 列表 查找 需要 连接 的 Wi-Fi 的 SSID。 查 找到 后 ， 连 接 到 对 应 
的 Wi-Fi 上 。 具 体 实现 如 代码 清单 4-22 所 示 。 


代码 清单 4-22 ” Wi-Fi 重 连 方法 具体 实现 


public static void CheckwifiConnection(){ 

IWifiManager im=IWifiManager.Stub.asInterface(ServiceManager 
.getService("wifi")); 

try { 
int state=im.getwifiEnabledSstate(); 
System.out.println(state); 
WifiInfo wi=im.getConnectionInfo(); 

if(state!=3)t{ 
// 打 开 


Wi-Fi 
System,.out,println("Wifi not conect, connecting wifi."); 
im.setwifiEnabled(true); 
/ /等待 


Wi -Fi 打开 ， 然 后 连接 


freewifi 
for(int i=0;i<90;i++){ 
if(im.getwifiEnabledSstate( )==3){ 
/ /连接 
freewifi 


List<wifiConfiguration> t=im.getConfiguredNetworks(); 
if(t!=null)t{ 
for(int j=0;j<t.size();]j++){ 
if(t.get(j).SsSID.indexof("Tencent-FreeWwirFi")!=-1)t{ 
int networkid=t.get(j).networkId; 
im.enableNetwork(networkid, true); 
Thread.sleep(7000); 
} 


break; 


上 


break 
}else{ 
hread.sleep(2000); 


} 


} 
} 
} catch (RemoteException e) { 
e.printStackTrace( ); 
} catch (InterruptedException e) { 
e.printSstackTrace( ); 
}catch (SecurityException e) { 
e.printStackTrace( ); 
} 
} 


前 面 说 的 需求 是 实现 定时 监控 ， 所 以 需要 在 Monkey.java 中 的 
runMonkeyCycles () 下 每 隔 1000 个 事件 就 插入 一 个 Wi-Fi 监 探 事 件 ， 
实现 如 代码 清单 4-23 所 示 。 


代码 清单 4-23 ”runMonkeyCycles 方 法 中 增加 Wi-Fi 监 控 事件 


private int runMonkeyCycles() { 
int eventCounter = 0 
int cycleCounter = 0; 
boolean shouldReportAnrTraces = false,; 
boolean shouldReportDumpsysMemInfo = false,; 
boolean shouldAbort = false; 
boolean systemCrashed = false,; 
// TO DO : The count should apply to each of the Script file. 
while (!systemCrashed && cycleCounter < mCount) { 


// 添 加 


Wi -Fi 检查 的 事件 一 
sharon 
if(cycleCounter%1000==0){ 
try { 
addwifiEvent( ) ， 
} catch (RemoteException e) { 
// TODO Auto-generated catch block 
e.printStackTrace( ); 
} 
} 
} 
System.out.println("Events injected: " + eventCounter); 


return eventCounter; 


这 样 ， 当 Monkey 每 执行 完 1000 个 事件 后 ， 束 会 去 检测 一 下 Wi-Fi 
的 连接 状态 ， 当 发 现 Wi-Fi 断 开 就 会 自动 重 连 。 重 新 编译 一 下 
Monkey， 然 后 看 一 下 效果 ， 当 Monkey 检 查 到 Wi-Fi 靳 开 如 图 4-22 所 示 
上 时， 会 自动 重 连 ， 如 图 4-23 所 示 。 
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图 4-22 ”执行 Monkey 时 网 络 被 断 开 
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图 4-23 Monkey 目 动 重 连 网 络 


4.4.4 Monkey 扩 展 应 用 的 优 点 和 缺点 

前 面 介绍 了 几 个 通过 源码 改造 扩展 使 用 Monkey 的 案例 ， 这 里 来 总 
结 一 下 Monkey 改 造 的 优点 和 缺点 。 Monkey 改 造 的 优点 非常 明显 ; 

不 依赖 PC 机 ， 是 一 种 很 好 的 单机 自动 化 模式 。 

.在 Monkey 内 部 可 以 调用 系统 底层 接口 ， 做 到 很 多 App 做 不 到 的 事 
情 。 

:基于 Monkey 源 码 的 改造 可 以 做 很 多 个 性 化 定制 。 

其 缺点 是 : 

被 测 手机 最 好 是 root 手 机 。 


如 前 面 所 说 ， 在 执行 Monkey 的 过 程 中 需要 对 Monkey 的 jar 包 和 
shell 脚 本 进行 授权 ， 如 果 不 是 root 手 机 ， 这 一 步 会 非常 肪 烦 。 


:不 同 Android 版 本 的 Monkey 不 通用 ， 不 利于 做 版 本 适 配 。 


为 Monkey 是 Android 系 统 目 市 的 ， 不 同 Android 版 本 的 Monkey 的 
代码 会 存在 差异 ， 例 如 2.3 版 本 的 Monkey 执 行 触摸 方法 时 是 通过 调用 
IWindowManager 的 injectPointerEvent 方 法 来 实现 的 。 


WindowManager .getIinstance().injectPointerEvent(me, false) 


而 4.0 版 本 的 Monkey 则 是 通过 调用 InputManagerH*JinjectInputEvent 
方法 来 实现 的 。 


InputManager .getInstance().injectIinputEvent(me, 
InputManager ,INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT) 


所 以 2.3 版 本 的 Monkey 在 4.0 版 本 的 Android 手 机 上 是 运行 不 起 来 
的 。 


4.5 ”本章 小 结 


Monkey 古 Android 测 试 中 第 用 的 一 个 稳定 性 测试 工具 ， 掌 握 
Monkey 工 具 本 喘 的 使 用 方法 是 非常 简单 的 。 但 是 真正 能 深入 了 解 
Monkey 的 代码 实现 逻辑 ， 并 且 具 备 优化 Monkey 能 力 的 人 ， 却 是 少 之 
又 少 。 通 过 本 草 ， 读 者 不 仅仅 可 以 学 习 到 Monkey 的 一 些 基 本 知识 和 基 
本 使 用 方法 ， 还 可 以 通过 对 Monkey 代 码 逻 辑 和 扩展 实例 的 学 习 ， 有 所 
局 发 ， 掌 握 新 的 目 动 化 测试 的 方案 。 


第 5 革 UIAutomator 框 架 及 实践 


本 章 将 从 四 个 维度 (图 5-1) 对 UIAutomator 自 动 化 框架 进行 介绍 ， 
由 浅 入 深 地 剖析 其 原理 ， 讲 述 在 TOS (Tencent OS， 腾 讯 基于 Android 开 
发 的 手机 系统 ) 测试 过 程 中 的 实践 案例 ， 围 绕 基 础 、 原 理 、 实 战 三 方 
面 ， 对 于 框架 特性 、 适 用 场景 进行 分 析 ， 为 二 次 开发 提供 思路 及 技 
巧 。 


` 发 展 历程 及 框架 特点 简介 


框架 解读 一 一 解读 基础 框架 及 核心 框架 UIAutomatorBridge 
ii Er f 读 一 一 源码 解读 控件 解析 及 事件 注入 原理 


API 解读 一 一 解读 公开 API， 无 须 精读 ， 可 供 开 发 过 程 查询 使 用 


[一 简介 


快速 上 手 一 创建 Demo 理解 框 
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图 5-1 本 章 知 识 结构 图 


UIAutomator 作 为 目 动 化 框 染 的 一 种 ， 其 初 囊 是 更 好 地 为 测试 服 
务 ， 是 确保 产品 质量 的 一 种 方法 ， 而 非 目 的 。 当 测试 的 思想 不 再 局 限 
于 框架 本 里 时 ， 我 们 可 以 更 好 地 改造 并 利用 其 为 测试 服务 ， 


UIAutomator 具 备 的 强大 兼容 性 及 应 用 的 灵活 性 ， 可 以 很 好 地 帮助 我 们 
解决 目 动 化 过 程 中 的 问题 。 


5.1 UIAutomator 简 介 


测试 领域 根据 代码 和 是否 可 见 可 划分 为 法 盒 测试 、 日 盒 测 坛 ， 从 执 
行 方式 的 不 同 可 划分 为 手工 测试 、 目 动 化 测试 。 在 实际 的 移动 端 测试 
过 程 中 ， 大 部 分 采用 敏捷 开发 的 团队 都 在 经 历 快速 的 需求 迭代 ， 为 了 
适应 其 快速 迭代 的 节奏 ， 在 测试 和 渤 型 上 往往 还 是 黑 盒 手工 测试 大 多。 
而 墨盒 手工 测试 可 以 说 是 所 有 测试 方法 中 最 耗 时 、 最 无 趣 、 最 易 出 错 
的 方法 ， 考 虑 到 日 盒 测试 的 成 本 太 高 ， 为 了 寻求 更 有 效 、 更 靠 谱 的 测 
试 方式 ，Android 官 方 提 供 了 一 登 黑 盒 UI 目 动 化 测试 框架 


UlIAutomator ° 


Android 官 方 关于 UI 测试 有 这 么 一 段 描述 ， 在 App 的 测试 过 程 中 ， 
除了 对 Android 的 单独 组 件 (如 Activity 、Service、Content 、Provider) 
进行 单元 测试 ， 测 试 应 用 运行 时 的 界面 行为 也 非常 必要 ， 通 过 测试 界 
面 行为 来 保证 应 用 在 用 户 一 系列 操作 后 ， 能 够 正确 地 呈现 用 户 预 期 的 


结果 。 


UIAutomator 是 为 数 不 多 的 Android 官 方 支持 的 自动 化 框架 之 一 ， 
关于 版 本 的 选择 可 以 参考 更 新 特性 。UIAutomator 随 着 Android 版 本 发 
布 而 更 新 ， 最 早 发 布 的 版 本 为 API Level 17。 作 为 基于 控件 的 自动 化 框 
架 ，UIAutoamtor 的 整体 框架 及 API 简 单 明 晰 ， 非 常 容 易 上 手 ， 发 布 后 
便 受 到 了 不 少 开 发 人 员 的 好 评 ， 但 仍 有 部 分 开发 人 员 觉 得 不 支持 


resourceId 检 索 探 件 有 点 儿 可 惜 。 官 方 在 随后 的 Level 18 中 弥补 了 这 一 
缺憾 ， 至 此 ，UIAutomator 便 在 自动 化 测试 领域 占据 了 一 局 之 地 ， 满 足 
了 大 部 分 开发 人 员 的 需求 。 


UIAutoamtor 较 于 其 他 目 动 化 框架 有 什么 特性 呢 ? 笔者 觉得 可 以 用 
粗暴 但 灵活 、 简 单 可 依赖 来 形容 ， 其 细 数 的 优势 有 很 多 ， 概 括 起 来 有 
DP ls 


-家 方 文 持 更 新: Android 原 生 文 持 ， 测 试 依赖 环境 少 ， 创 建 方 
便 。 


层次 接口 明晰 : 框架 层次 结果 分 明 ，API 明 晰 ， 上 和 手 成 本 很 低 。 


-基于 控件 交互 : 文 持 Android 原 生 控 件 解 析 ， 比 坐标 交互 兼容 性 
更 独 * 


不 依赖 于 源码 ， 测试 过 程 基于 黑 盒 进行 ， 对 所 有 发 行 版 本 都 可 以 
测试 。 
事件 等 待 优秀 ， 在 事件 等 待 方面 接口 丰富 ， 控 制 灵 活 精确 ， 表 现 


优秀 。 


:支持 跨 进 程 测试 ， 在 自动 化 框架 中 ， 具 备 此 特性 的 不 多 ， 测 试 范 
围 在 ROM 层 面 。 


较 于 其 他 框架 来 说 ， 不 足 的 地 方 就 是 UIAutomator 仅 支持 API Level 
17 及 以 上 ， 且 控件 解析 仅 支 持 Android 原 生 控 件 ， 对 于 Web 则 无 法 解 
析 。 随 着 市 场 上 的 设备 逐步 更 新 ，API Level 17 以 上 的 设备 普及 率 也 越 
来 越 高 ， 这 个 缺点 慢 慢 就 不 再 是 框架 的 短 板 了 。 而 Web 人 解析， 确实 是 
框架 选 型 的 时 候 需 要 注意 的 地 方 ， 我 们 只 能 期 盼 着 官方 后 续 的 更 
新 ， 会 考虑 对 这 方面 做 出 支持 。 


Rt 


在 技术 选 型 方面 ， 除 了 涉及 Web 的 测试 ，UIAutomator 基 本 上 都 可 
以 帮 用 户 实现 。 如 果 用 户 想 做 ROM 层 级 的 测试 ， 或 是 App 间 协作 需 跨 
进程 的 测试 ， 那 UIAutomator 将 是 非常 好 的 选择 ; 用户 澳 望 写 出 简单 易 
懂 而 功能 强大 的 代码 ， 也 不 妨 选 择 一 试 ，UIAutomator 可 以 让 用 户 在 事 
件 等 待 方面 看 到 它 优 雅 的 一 面 ， 没有 代码 没关系 ， 想 要 竞 品 对 比 也 可 
以 ， 单 元 测试 、 性 能 测试 、 压 力 测试 ，UIAutomator 都 可 以 成 为 用 户 的 
选择 ;简单 而 不 简约 ， 留 给 开发 人 员 更 目 由 的 发 挥 空 间 ， 轻 巧 灵动 ， 


强大 可 靠 ， 这 就是 UIAutomator 。 


5.2 ”UIAutomator 解 读 


有 个 小 故事 ， 某 程序 员 退 休 后 决定 练习 书法 ， 于 古 重 金 购 洋 了 文 
房 四 宝 。 一 日 ， 饭 后 突 生 雅 兴 ， 一 番 人 研 誉 拟 纸 ， 并 点 上 上 好 檀 香 ， 害 
神 片 刻 ， 痰 礁 挥 晤 ， 戏 重地 写 下 一 行 字 : Hello World! 


这 人 句 话 对 于 程序 员 来 讲 再 熟悉 不 过 了 ， 不 是 程序 员 都 体会 不 到 这 
句 话 的 伟大 所 在 。 这 几 个 简单 的 字符 ， 往 往 意 味 着 一 个 新 的 开始 和 一 
段 新 的 征程 ， 作 为 殴 门 想 一 次 次 地 打开 新 世界 的 大 |[。 当 程序 员 首 次 
邂逅 一 项 新 技术 的 时 候 ， 大 概 都 是 迫 不 及 行 地 想 着 这 件 事情 吧 。 不 
过 ， 在 这 里 让 我 们 先 按 探 住 目 己 内 心 的 小 激动 ， 为 了 后 续 能 信 手 牛 来 
玩 得 更 好 ， 避 人 免 一 些 先入 为 主 的 误区 ， 还 是 先 来 解析 一 下 UIAutomator 
的 框架 及 工作 原理 。 


5.2.1 UIAutomator 框 架 解读 
对 于 UIAutomator 的 框架 ， 官 网 公开 的 分 类 只 有 下 面 九 类 ， 具 体 如 
下 : 
-UIAutomationSupport: UI 测试 信息 拓展 类 。 
:UIAutomatorTestCase: UI 测试 基 类 。 
-UICollection: UI 测试 控件 集合 。 
-UIDevice: UI 测试 设备 抽象 。 
-UIObject: UI 测试 控件 抽象 。 
:UIObjectNotFoundException: UI 测试 控件 无 法 找到 的 异常 。 
-UIScrollable: UI 测试 可 深 动 控件 。 
-UISelector: UI 测试 控件 选择 颖 。 
-UIWatcher: UI 测试 界面 观察 者 。 


对 于 普通 的 目 动 化 测试 来 说 ， 这 九 类 已 经 基本 能 满足 开发 人 员 的 
所 有 测试 需求 了 ， 甚 至 可 以 说 只 需要 熟悉 其 中 几 个 就 可 以 开始 做 
Android 界 面 自动 化 测试 了 ， 但 一 些小 众 却 比较 实用 的 类 也 建议 有 所 了 


解 。 以 下 将 从 UIAutomator 基 础 框架 及 稍 深入 一 些 的 UIAutomatorBridge 


框架 来 介绍 UIAutomator 。 
1.UIAutomator 基 础 框架 


UIAutomator 基 础 框架 作为 开发 人 员 入 门 知 识 ， 掌 握 后 即 可 开始 应 
用 开发 ， 如 图 5-2 所 示 。 


URaamaioTesicas 


-mSelector: UiSelector -mSelectorAttributes: SparseArray<Object>|| -mUiDevice: UiDevice 
-mMUiAutomationBridge: UiAutomatorBridge | |+ie xt(Sting text) -mParams: Bundle 


+getText() +t+resourceld(String id) tassert() 
+getChild(UiSelector selector) +childSelector(UiSelector selector) +getAutomationSupportl) 
+clickAndWaitForNewWindow!() +classNamelStnng className) +getParams() 
+setText(String text) +descriptionMatches(Stnng regex) +getNamel) 
+swipeDown(int steps) tlongClickable(boolean val) +getUiDevice() 
+waitForExists{long timeout) +sleep(long ms) 
+waitUntilGone(long timeout) 


:ppp 


UiCollection 
和 
+getChildByDescription[UiSelecior childPattern, String text) 
+getChildByinstance(UiSelector childPattern, int instance) 
+getChildByText(UiSelector childPattern, String text) 

+getChildCount(UiSelector childPattern) 


Viserolehie 


TT : ER 
NG 人 55 ; +getActionAcknowledgmentTimeout() 
-DEFAULT_SWIPE DEADZONE PCT: double =0.1 ;| PeestnDelay) 

: +getWaitForldleTimeout() 
+fingBackward() ' +getWaitForSelectorTimeout!) 
+scrollForward(int steps) : +setActionAcknowledgmentTimeout(long timeout) 
+scrolToBeginning(int maxSwipes) : +setKeyinjectionDelay(long delay) 
tsetAsHorizontalList() : +setWaitForldleTimeout(long timeout) 
+scrollntoView(UiSelector selecior) : +SsetWaitForSelectorTimeoutllong timeout) 
+getChildByText(UiSelector childPattern, String text) 


UiObjectNotFoundException 
-mUiAutomationBridge: UiAutomatorBridge 


六 - +UiObjectNotFoundException(Stnng msg) 
ee oy ER : +UiObjectNotFoundException(Throwable throwable) 
+clicklint x. inty) () 


+swipe{Pointl] segments, int segmentSteps) 


ttakeScreenshot(File storePath) UiWatcher 

+pressHomel) ee 

+getDisplayWidth0 +checkForCondition() () 
+waitForlde(longtimeout) IE 1 
+watForWindowUpdate(Strng packageName, long timeout) lAutomationSupport 
+registerWatcher(String name, UiWatcher watcher) +sendStatus(int resultCode, Bundle status) 


图 5-2 ”UIAutomator 基 础 框架 


上 图 中 除了 OurTestCase 为 我 们 的 目 动 化 用 例 ， 框 架 ， 共 10 个 类 ， 
可 以 分 为 一 基 类 一 配置 、 一 设备 一 异常 、 两 接口 三 控件 外 加 一 个 选择 
证 。 其 中 使 用 最 多 的 五 大 基础 类 为 UiDevice、UiSelector、UiObject、 


UiCollection、UiScrollable， 接 下 来 我 们 以 功能 分 类 ， 看 一 下 这 些 类 的 
具体 作用 。 


1) 基 类 : UiAutomatorTestCase 


作用 : 测试 基 类 ， 所 有 测试 用 例 部 要 继承 于 它 ， 人 负责 执行 参数 及 
用 例 信息 获取 。 


描述 : UIAutomator 在 执行 的 时 候 会 进行 有 效 性 检查 ， 只 有 继承 于 
这 个 类 的 用 例 才 可 以 被 执行 。 这 个 基 类 继承 于 
junit.framework.TestCase， 执 行 sSetup、test、tearDown 的 Junit 用 例 流程 ， 
遵循 Assert (断言 ) 的 用 例 设计 思想 。 


2) 配置 Configurator 


作用 : 配置 基础 类 ， 用 以 控制 测试 过 程 的 事件 等 竺 超时、 控件 可 
见 超时 等 。 


接 述 : Configurator 这 个 类 容易 被 忽视 ， 其 剑 存 了 测试 过 程 中 关于 
事件 注入 的 超时 参数 。 通 过 设置 这 些 参数 可 以 控制 操作 的 一 些 时 长 ， 
比如 通过 修改 控件 可 见 超时 保证 控件 匹配 时 获得 更 多 时 间 ， 通 过 修改 
事件 等 待 时 长 模拟 快速 双击 ， 等 等 。 


3) 设备 : UiDevice 


作用 : 设备 封 狐 类， 测试 过 程 获取 设备 信息 、 与 设备 交互 。 


描述 ，UiDevice 是 对 当前 测试 设备 的 抽象 ， 通 过 它 可 以 获取 设备 的 
高、 设备 型 号 等 信息 ， 使 用 它 可 以 向 设备 发 送 指令 ， 比 如 截 
图 、 腕 炙 屏 、 扩 击 、 滑 动 等 。 


4) 异常 : UiObjectNotFoundException 


作用 : 异常 处 理 机 制 ， 在 预期 控件 不 存在 时 间 上 抛 出 。 


描述 ， 当 向 预期 控件 发 出 操作 指令 ， 控 件 不 存在 时 向 上 抛 出 ， 访 
框架 唯一 异常 


5) 接口 : UiWatcher 


作用 : 界面 观察 者 ， 处 理 弹 窗 中 断 逻 辑 。 


摘 述 : UiWwatcher 其 实 是 一 个 接口 ， 实 现 该 接口 的 实例 可 以 回 
UiDevice 注 册 作为 界面 观察 者 。 在 测试 过 程 中 ， 一 旦 有 其 他 应 用 界面 弹 
窗 跳 出 ， 为 了 避免 测试 中 断 ， 该 实例 对 应 的 接口 方法 就 会 被 回调 ， 用 
以 处 理 中 断 弹 窗 以 便 测试 继续 进 


6) 接口 : IAutomationSupport 


作用 : 测试 辅助 支撑 类 ， 用 于 发 送 测 试 状态 。 


搞 述 : 该 类 用 的 频率 很 低 ， 可 以 辣 测 试 过 程 中 的 用 例 发 送 状 态 及 
1 


7) 选择 器 : UiSelector 


作用 : 控件 选择 右 ， 利 用 控件 属性 摘 述 目标 控件 ， 供 控件 匹配 使 


接 述 :UiSelector 用 于 摘 述 目标 控件 ， 只 是 作为 属性 信息 的 转 储 。 
在 界面 解析 的 时 候 ， 利 用 存储 的 属性 对 控件 进行 约束 ， 过 滤 出 我 们 想 
要 的 控件 。 在 自动 化 测试 过 程 中 ，UiObject 拥 有 其 作为 成 员 变量 ， 使 用 
非常 广泛 ， 我 们 需要 做 的 是 ， 利 用 其 属性 描述 来 约束 控件 的 唯一 性 。 


8) 控件 : UiObject 
作用 : 所 有 控件 抽象 ， 用 以 表示 一 个 Android 控 件 。 


描述 : 类 似 于 Java 中 的 Object， 它 是 所 有 控件 的 超 类 ，UIAutomator 
中 关于 控件 的 抽象 程度 很 高 ，ListView、TextView、Button 等 ， 都 用 
UiObject 来 表示 ， 所 以 UiObject 也 包含 了 绝 大 部 分 控件 的 操作 ， 包 括 点 
击 、 文 字 输 入 、 拖 搜 等 。 无 控件 ， 不 自动 化 ， 在 上 自动 化 编写 过 程 中 ， 
这 个 类 使 用 的 频率 是 最 高 的 。 


9) 控件 : UiCollection 


作用 : 控件 集合 ， 用 于 控件 遍历 。 


描述 : 继承 于 UiObject， 表 示 符 合同 一 条 件 的 控件 集合 ， 拓 展 了 获 
取 界 面子 节点 元 素 的 方法 。 当 界面 存在 多 个 控件 而 无 法 用 UiSelector 描 
述 目标 控件 的 唯一 性 ， 或 需要 对 界面 元 素 进 行 志 有 历 操 作 时 ， 可 以 使 用 
UiCollection 来 进行 。 


10) 控件 : UiScrollable 


作用 : 滚动 控件 ， 当 目标 控件 存在 于 屏幕 之 外 时 使 用 。 


摘 述 : 继承 于 UiCollection， 使 用 该 控件 描述 界面 滑动 列表 ， 当 目 
标 控件 存在 于 可 见 范 围 之 外 时 ， 可 以 使 用 getChild 系 列 方法 来 获取 ， 
UiScrollable 会 自动 完成 消 动 操作 以 裔 历 列表 里 的 所 有 元 素 。 


综 上 所 述 ， 在 实际 目 动 化 过 程 中 ， 使 用 UiSelector 对 目标 控件 进行 
描述 ， 根 据 需要 选择 三 个 控件 类 别 得 到 目标 控件 实例 ， 通 过 实例 与 控 
件 进 行 交 互 ， 或 者 是 通过 UiDevice 对 设备 进行 交互 ， 期 间 可 以 通过 
Configurator 修 改 配置 ， 通 过 UiWwatcher 处 理 弹 窗 中 断 ， 捕 获 异 常 或 是 使 
用 Assert 来 对 用 例 结 采 进行 判断 。 


2.UiAutomatorBridge 框 架 


作为 基于 控件 的 目 动 化 测试 框架 ， 有 两 件 比 较 重要 的 事情 ， 即 界 
面 解析 和 事件 注入 。 界 面 解析 以 获取 目标 控件 ， 事 件 注 入 以 完成 操作 


交互 。 在 UIAutomator 框 架 中 要 了 解 这 两 件 事情 是 怎样 完成 的 ， 就 不 得 
不 说 到 UiAutomatorBridge 。 


在 UIAutomator 目 动 化 测试 过 程 中 ， 界 面 解 析 和 事件 注入 最 终 部 依 
赖 于 UiAutomation 来 完成 ， 而 UiAutomatorBridge 相 当 于 UiAutomation 的 
代理 ， 作 为 两 者 之 间 调 用 的 桥梁 ， 几 乎 所 有 事件 的 处 理 及 交互 ， 都 经 
过 UiAutomatorBridge 进 行 派发 。 


UiAutomatorBridge 框 架 如 图 5-3 所 示 。 


图 5-3 所 示 为 与 UiAutomatorBridge 相 天 的 核心 类 ， 其 中 事件 起 源 为 
UiDevcie，UiAutomatorBridge 作 为 代理 ， 回 UiAutomation 派 发 事件 取得 


数据 ， 有 具体 事务 管理 由 QueryController、Interaction-Controller 与 
ShellUiAutomatorBridge 来 完成 。 


-UiAutomatorBridge 与 UiDevice 的 关系 : UiDevice 成 员 变量 中 拥有 
UiAutomatorBridge 的 实例 ， 视 其 为 UiAutomation 的 代理 ， 所 有 与 界面 解 
析 及 事件 注入 相关 的 事务 ， 都 调用 UiAutomatorBridge 来 进行 


.UiAutomatorBridge 与 QueryController、InteractionController 的 天 


系 : UiAutomatorBridge 有 两 个 助手 ， 即 QueryController 与 


InteractionController，QueryController 负 责 界 面 解析 事务 (把 UiSelector 
转换 成 AccessibilityNodeInfo) ， 而 InteractionController 负 责 事件 注入 事 


务 。 当 UiAutomatorBridge 从 UiDevice 获 取 指 令 后 ， 并 不 是 直接 与 
UiAutomation 进 行 交 互 ， 而 是 根据 事务 属性 ， 调 用 对 应 的 类 去 执行 。 


'UiAutomatorBridge 与 ShellUiAutomatorBridge 的 关系 : 在 


UiAutomatorBridge 中 ，getRotation、isScreenOn 等 方法 是 没有 具体 的 实 
现 的 ， 为 什么 呢 ? 在 UiAutomatorBridge 中 ， 大 部 分 方法 都 是 需要 调用 
UiAutomation 才 能 完成 的 ， 当 然 也 有 部 分 不 需要 调用 UiAutomation 的 方 
夫 。 为 了 代码 有 更 好 的 维护 性 ， 这 部 分 方法 就 被 抽取 出 来 ， 在 
ShellUiAutomatorBridge 中 实现 。 


-UiAutomatorBridge 人 与 UiAutomation 的 关系 : UiAutomatorBridge 持 
有 UiAutomation 的 实例 作为 成 员 变 量 ，QueryController 及 
InteractionController 在 执行 事务 的 时 候 ， 会 通过 UiAutomatorBridge 来 获 
得 UiAutomation 的 实例 进行 调用 。 


QeryConroler 
-mUiAutomatorBridge: UiAutomatorBndge -mUiAutomationConnection: IUiAutomationConnection 


+getLastTraversedTexi() 
+clearLastTraversedTexi() 
+findAccessibilityNodelnfo(UiSelector selector) 
+getRootNode() 


-mClient |AccessibilityServiceClient 
-mEventQueue: ArrayList<AccessibilityEvent> 


+getRootinActiveWindow!() 


t+executeShellCommand(String command) 
+injectinputEvent(InputEvent event, boolean sync) 
+setRunAsMonkey(boolean enable) 
+takeScreenshot() 


+translateCompoundSelector() 
+translateReqularSelector() 
+translatePatternSelector() 
+getAccessibilityRootNode!() 


InteractionController 人 
-mUIAutomatorBridge: UiAutomatorBndge UiAutomatorBridge 


+runAndWaitForEvents() -minteractionController: InteractionController 


+sendKeyAndWaitForEvent() -mQueryController QueryControlier 
+clickNoSync(int x, int y) -mMUiAutomation: UiAutomation 
+clickAndSync(final int x, final int y, long timeout) - 
+clickAndWaitForNewWindow(final int x, final int y) +getRootinActiveWindow() 

+longTapNoSync(int x, int y) tinjectinputEvent(InputEvent event boolean sync) 
+touchDown(int x, int y) +waitForldle(long timeout) | | 
+touchUp(int x, int y) +takeScreenshot(File storePath, int quality) 
+touchMove(int x, int y) +performGlobalAction(int action) 

+swipe(Pointl] segments, int segmentSteps) 八 


+injectEventSync(InputEvent event) 


we | SnelUiAvtomatoreridge 
-mUiAutomationBridge: UiAutomatorBridge 
-mWatchersTriggers: List<String> +getDefaultDisplay() 

-mWatchers: HashMap<Stnng.UIWatcher> 


+click(int x, int y) 
+swipe(Point] segments, int segmentSteps) 


+takeScreenshot(File storePath) 

+t+pressHome!() 

+getDisplayWidth() 

+waitForldle(long timeout) 

+registerWatcher(String name, UiWatcher watcher) 


图 5-3 ”UiAutomatorBridge 框 架 


@ 提示 ”在 实际 的 自动 化 过 程 中 ，UiDevice 中 持 有 的 实例 对 象 并 
不 是 UiAutomatorBridge， 而 是 其 子 类 ShellUiAutomatorBridge 。 


5.2.2 ”UIAutomator 原 理解 读 


刚 开 始 接触 UIAutomator 的 时 候 ， 为 了 快速 上 手 赶 进度 ， 只 是 学 习 
框架 怎么 使 用 ， 对 于 一 些 存在 的 问题 及 现象 ， 并 没有 进行 深入 的 了 
解 。 比 如 ， 为 什么 在 UIAutomator 执 行 过 程 中 整体 感觉 会 比较 慢 ? 为 什 
么 在 自动 化 执行 过 程 中 ，logcat 中 会 不 断 看 到 getText () 的 日 志 输 出 ? 
为 什么 明明 调用 了 UiScrollable 的 scrollForward 但 没有 作用 .……… 


那 时 候 觉 得 描述 当前 页 面 滑动 列表 的 写法 束 一 定 是 这 样 的 : 


Uiscrollable mList = new UiScrollable(new UiSelector().scrollable(true)); 


最 关键 的 是 ， 一 定 要 有 scrollable (true) ， 后 面 在 做 MIUI 系 统 自动 
化 对 比 测试 的 时 候 ， 突 然 发 现 界面 解析 出 来 的 滑动 列表 控件 属性 中 
scrollable 为 false (MIUI 系 统 屏 蔽 该 属性 ) ， 才 明白 通过 其 他 方法 也 可 
以 获得 滑动 控件 进行 使 用 。 


来 看 一 段 简单 的 代码 ， 如 代码 清单 5-1 所 示 ， 原 意 很 简单 ， 只 是 想 
寻找 界面 中 text 文 案 为 “确定 ”的 按钮 ， 如 果 按 钮 存在 ， 单 击 它 。 对 于 一 
个 Java 程 序 员 来 讲 ， 这 样 的 代码 应 该 习以为常 了 ， 申 请 一 个 对 象 ， 如 果 
对 象 不 为 空 ， 则 对 其 进行 操作 ， 再 正 稍 不 过 了 。 


代码 清单 5-1 单 击 确定 按钮 


/** 
* 单 击 确定 按钮 


” @throws UiobjectNotFoundException 
UiobjectNotFoundException 
*/ 
public void clickPositiveButton() throws UiOobjectNotFoundException { 
Uiobject mpPositiveButton = new UiObject(new UiSelector() 
.ClassName(Button.class).text(" 确 定 


/ 
if(null != mPositiveButton) 
mPositiveButton,.click()， 


那么 问题 来 了 ， 这 里 判断 了 null! =mPositiveButton， 再 调用 
mpPositiveButton 的 click 方 法 ， 就 能 确保 用 例 执行 顺利 ， 不 抛 出 异常 了 
吗 ? 答案 是 否定 的 ， 如 果 当 前 页 面 不 存在 “确定 ”按钮 ， 程 序 在 执行 
mpPositiveButton.click () 的 时 候 仍 然 会 抛 出 
UiObjectNotFoundException。 有 点 儿 不 明白 ， 为 什么 呢 ? 这 里 
mpPositiveButton 应 该 不 为 空 才 对 。 


通常 来 讲 ， 这 里 很 可 能 会 有 一 个 先入 为 主 的 想法 ， 就 是 当 
mpPositiveButton 完 成 new 的 动作 后 就 已 经 完成 了 当前 界面 的 解析 并 找到 
了 这 个 控件 ， 将 其 赋予 了 mpPositiveButton 这 个 变量 。 这 样 的 话 ， 按 上 面 
代码 的 逻辑 ， 确 实 不 应 该 抛 出 UiObjectNotFoundException。 好 的 ， 带 着 
疑问 ， 让 我 们 来 看 一 下 实际 的 过 程 是 怎么 样 的 ， 我 们 找到 UiObjectjava 
中 关于 构造 方法 的 代码 ， 如 代码 清单 5-2 所 示 。 


代码 清单 5-2 ”UiObject.java 构 造 方 法 


71 /** UiObject.java 


72 * Constructs a Uiobject to represent a view that matches 
73 * the specified selector criteria， 

74 * @param selector 

75 * @since API Level 16 

76 up 

77 public Uiobject(UiSelector selector) { 

78 mSelector = selector; 

79 } 


从 上 面 代 码 中 可 以 看 出 ， 在 UiObject 申 请 实例 的 时 候 ， 只 是 把 参数 
selector 赋 予 了 成 员 变 量 mSelector， 其 他 什么 动作 也 没有 发 生 。 这 样 看 
来 ， 上 面 “null! =mpPositiveButton” 的 判断 基本 是 白 写 了 ， 因 为 
mpPositiveButton 基 本 上 可 以 认为 申请 实例 一 定 会 成 功 。 那 么 界面 解析 的 
过 程 在 哪里 呢 ? 


剩 下 的 唯一 语句 ， 就 只 有 “mpPositiveButton.click () ; ”这 一 句 了 ， 
估计 这 里 面 大 有 文章 。 在 这 里 我 们 不 妨 以 其 为 例 ， 来 解读 一 下 
UIAutomator 界 面 解析 和 事件 注入 的 过 程 ， 提 取 大 致 的 流程 ， 画 出 时 序 
图 ， 如 图 5-4 所 示 。 
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图 5-4 ”UIAutomatorBridge 杠 染 


我 们 从 代码 层面 来 解析 这 个 过 程 ， 当 mpositiveButton 调 用 dlick () 


方法 时 ， 


源码 如 代码 清单 5-3 所 示 。 


代码 清单 5-3 ”UiObject.click 方 法 


380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 


391 
392 
393 
394 


/** UiObject.java 
Performs a click at the center of the visible bounds of 
the UI element represented by this Uiobject ， 


Q@return true id successful else false 
@throws UiObjectNotFoundException 
Q@since API Level 16 


public boolean click() throws UiObjectNotFoundException { 
Tracer .trace()， 
AccessibilityNodeInfo node = findAccessibilityNodeInfo( 
mConfig.getwaitForSelectorTimeout()); 
if(node == null) { 
throw new UiObjectNotFoundException(getSelector().tostring()); 
} 


Rect rect = getVisibleBounds(node); 


395 return getIinteractionController().clickAndSsync(rect.centerXx(), 
396 rect.centerY(), mConfig.getActionAcknowledgmentTimeout()); 
397 } 


从 上 面 的 代码 可 以 看 到 ，390 行 先是 调用 findAccessibilityNodelInfo 
获得 控件 的 节点 信息 ，394 行 再 根据 市 点 信息 获得 控件 边框 信息 ， 最 后 
395 行 调用 dickAndSync 根 据 坐 标 进 行 点 击 ， 其 中 获得 市 点 信息 代码 
findAccessibilityNodeInfo 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 UiObject.findAccessibilityNodeInfo 方 法 


155 /** UiObject.java 


156 * Finds a matching UI element in the accessibility hierarchy, by 
157 * using the selector for this Uiobject , 

159 * @param timeout in milliseconds 

160 * @return AccessibilityNodeInfo if found else null 

162 */ 


163 protected AccessibilityNodeInfo findAccessibilityNodeInfo( 
long timeout) { 


164 AccessibilityNodeInfo node = null; 

165 long startMills = SystemClock.uptimeMillis(); 

166 long currentMills = 0; 

167 while (currentMills <= timeout) { 

168 node = getQueryController(). 
findAccessibilityNodeInfo(getSelector()); 

169 if (node != null) { 

170 break; 

171 } else { 

172 // does nothing if we're reentering another runwatchers() 

173 UiDevice.getIinstance().runwatchers(); 

174 } 

175 currentMills = SystemClock.uptimeMillis() - startMills,; 

176 if(timeout > 0) { 

177 SystemClock.sleep(WAIT_FOR_SELECTOR_POLL); 

178 } 

179 

180 return node; 

181 } 


在 findAccessibilityNodeInfo 方 法 中 ， 天 键 语句 为 168 行 ， 调 用 
getQueryController 取 得 QueryController 


(UiDevice ~” getAutomatorBridge ~ getQueryController) ， 再 调用 


QueryController.findAccessibilityNodeInfo 方 法 获得 控件 节点 信息 ， 如 代 
码 清单 5-5 所 示 。 


代码 清单 5-5 QueryController.findAccessibilityNodeInfo 方 法 
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protected AccessibilityNodeInfo findAccessibilityNodeInfo(UiSelector 


cm 


selector, boolean isCounting) { 
mUiAutomatorBridge.waitForIdle( ); 
initializeNewSearch(); 


if (DEBUG) 
Log.d(LOG_ TAG, "Searching: " + selector); 


Synchronized (mLock) { 
AccessibilityNodeInfo rootNode = getRootNode(); 
If (rootNode == null) { 
Log.e(LOG_ TAG, "Cannot proceed when root node is null."); 
return null; 


} 


// Copy so that we don't modify the original's sub selectors 
UiSelector uiSelector = new UiSelector(selector); 

return translateCompoundSelector(uiSelector, rootNode, 
isCounting); 


在 QueryController 的 findAccessibilityNodeInfo 方 法 中 ， 主 要 有 两 个 


步 又 ， 


先 调 用 150 行 getRootNode 得 到 当前 的 根 节 点 ， 然 后 158 行 再 使 用 


selector 根 据 根 方 点 裔 历 得 到 目标 控件 节点 信息 。 获 取 根 节点 的 过 程 如 
代码 清单 5-6、 代 码 清单 5-7 所 示 。 


代码 清单 5-6 ”QueryController.getRootNode 方 法 


* @return null if no root node is obtained 


protected AccessibilityNodeInfo getRootNode() { 


final int maxRetry = 4; 

final long waitIinterval = 250; 
AccessibilityNodeInfo rootNode = null; 
for(int x = 0; x < maxRetry; x++) { 


172 rootNode = mUiAutomatorBridge.getRootInActivewindow( ); 


173 if (rootNode != null) { 

174 return rootNode; 

175 

176 if(x < maxRetry - 1) { 

177 Log.e(LOG_ TAG, "Got null root node - Retrying..."); 
178 SystemClock.sleep(waitInterval); 

179 

180 

181 return rootNode,; 

182 } 


代码 清单 5-7 UiAutomatorBridge.getRootInActiveWindow 方 法 


65 public AccessibilityNodeInfo getRootInActiveWindow() { 
66 return mUiAutomation.getRootInActivewindow( ) ， 
67 } 


在 getRootNode 方 法 中 ， 可 以 看 到 172 行 调用 的 是 
on ni () 方法 来 获取 得 到 Root 
太 点 ， 而 最 终 UiAutomatorBridge 调 用 


mUiAutomation.getRootInActiveWindow () 方法 来 获取 。 顺 利 取 得 根 节 
点 的 信息 后 ，QueryController 再 调用 translateCompoundSelector 方 法 把 
selector 转 换 成 对 应 的 AccessibilityNodeInfo 。 


至 此 ， 界 面 解析 的 过 程 结束 。 接 下 来 是 事件 注入 的 过 程 ， 如 代码 
清单 5-3 中 394、395 行 ， 通 过 返回 的 节点 信息 取得 边框 信息 ， 调 用 


getInteractionController () 获得 InteractionController 实 例 


(UiDevice =» getAutomatorBridge ~ getInteractionController) ， 通 过 


clickAndSync 来 完成 点 击 事件 注入 ， 而 clickAndSync 方 法 是 通过 调用 
runAndWaitForEvents 来 实现 的 ， 如 代码 清单 5-8 所 示 。 


代码 清单 5-8 ”InteractionController.runAndWaitForEvents 方 法 


private AccessibilityEvent runAndwaitForEvents(Runnable command, 


AccessibilityEventFilter filter, long timeout) { 


try { 
return mUiAutomatorBridge,; 


executeCommandAndwaitForAccessibilityEvent( 
command, filter,timeout); 

} catch (TimeoutException e) { 
Log.w(LOG_TAG, "runAndwaitForEvent timedout waiting events"); 
return null; 

} catch (Exception e) { 
Log.e(LOG_ TAG, "exception executewWaitForAccessibilityEvent",e); 
return null; 


实际 上 ，InteractionController 在 161 和 162 行 处 调用 了 
UiAutomatorBridge 去 执行 事件 注入 
executeCommandAndWaitForAccessibilityEvent。 在 该 方法 中 ， 事 件 被 圭 
竣 成 runable-Command， 由 于 该 调用 来 目 clickAndSync， 跟 进 可 以 发 现 
这 里 使 用 的 是 dickRunnable， 如 代码 清单 5-9 所 示 。 


代码 清单 5-9 


UiAutomatorBridge.executeCommandAndWaitForAccessibilityEvent 方 法 
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public AccessibilityEvent executeCommandAndwaitForAccessibilityEvent 
(Runnable command,AccessibilityEventFilter filter, long timeoutMillis) 
throws TimeoutException { 


return mUiAutomation.executeAndwaitForEvent(command, 
filter, timeoutMillis); 


UiAutomatorBridge 最 终 指向 UiAutomation， 所 有 事件 最 终 都 交 给 它 
去 执行 。 到 这 里 我 们 大 体 理 清 了 UIAutomator 界 面 解 析 和 事件 注入 的 流 


程 ， 可 以 稍 做 总 结 如 下 : 
:UIAutomator 界 面 解 析 、 事 件 注入 均 由 UiAutomation 来 完成 。 


-UiObject 对 象 可 以 理解 成 使 用 时 才 被 实例 化 ， 每 次 调用 都 会 重新 
解析 实例 化 。 


-UIAutomator 的 操作 事件 非 基 于 控件 ， 最 终 部 转换 为 坐标 执行 。 


-控件 所 历 过 程 中 每 次 只 返回 一 个 市 点 信息 而 不 是 控件 树 ， 效 率 比 
较 低 。 


5.2.3 ”UIAutomator API 解 读 


分 析 完 UIAutomator 的 框架 和 原理 后 ， 接 下 来 我 们 通过 分 类 来 解读 
其 API， 了 解 常 用 的 API 及 其 使 用 场景 ， 首 先 从 整体 来 看 一 下 
UIAutomator 执 行 时 的 指令 : 


# adb shell uiautomator runtest <jar> -c <test _class or_method> [options] 


UIAutomator 为 Android 目 带 的 可 执行 程序 ， 用 来 执行 与 
UIAutomator 目 动 化 测试 相关 事宜 ， 一 般 通 过 adb shell 来 调用 ， 当 然 ， 
在 手机 端 使 用 runTime 执 行 也 是 可 以 的 。 下 面 详细 介绍 指令 中 的 几 个 参 
数 ， 了 解 它 们 分 别 是 什么 意思 及 是 怎么 使 用 的 。 


(1) runtest。runtes 是 执行 测试 的 关键 指令 ， 对 应 的 指令 还 有 一 
个 “events” (用 于 打印 accessibility 事 件 到 控制 台 ， 直 至 设备 断 开 连 
接 ) 。 由 于 events 使 用 的 频率 较 低 ， 以 下 的 参数 介绍 均 基 于 runtest 指 令 
来 进行 。 


(2) <jar>。<jar> 是 紧 跟 在 runtest 后 面 的 参数 ， 用 于 指定 需要 执行 
的 测试 用 例 所 在 的 jar 包 名 称 ， 使 用 相对 路 径 〈UIAutomator 的 jar 包 放置 
于 /data/localtmp/ 目 未 下 ) ， 可 以 多 指定 。 


知 只 存在 一 个 测试 jar 包 A.jar， 直 接 写 代码 如 下 : 


# adb shell uiautomator runtest A.jar -c <test_class_or_method> [options] 


若 A.jar 测 试 过 程 中 引入 了 第 三 方 jar 包 B.jar， 则 并 列 写 ， 中 间 使 用 
空格 符 分 隔 即 可 ， 代 码 如 下 ; 


# adb shell uiautomator runtest A.jar B.jar -c <test_class_or_method> [options] 


(3) -c<test_class_or_method>。 其 用 以 指定 测试 具体 的 Case， 参 
数 指 定时 需要 写 全 量 路 径 ( 包 和 名 .class#method) ， 可 以 有 三 种 指定 方 
式 。 此 处 假设 A.jar 中 存在 两 个 测试 类 C.java、D.java， 分 别 存 在 测试 方 
法 C.testC_e、C.testC_f、D.testD_g、D.testD_h， 则 以 下 不 同 的 指定 方 
式 会 有 不 同 的 效果 。 


什么 也 不 指定 : 会 执行 指定 jar 包 中 所 有 的 测试 用 例 〈 以 test 开 头 的 
方法 ， 通 过 反射 进行 调用 ， 无 执行 顺序 ) ， 在 此 会 执行 testC_e、 


testC_f、testD_g、testD _h。 


# adb shell uiautomator runtest A.jar 


指定 测试 用 例 类 名 ”(-c class) : 会 执行 指定 类 下 的 所 有 用 例 ， 如 
条 有 多 个 类 可 以 并 列 指定 ， 中 间 用 空格 符 分 隔 开 ， 如 以 下 指令 会 运行 


testC_e、testC f° 


# adb shell uiautomator runtest A.jar - 


c com.tencent.uiAutotest.c 


指定 测试 用 例 类 名 加 方法 名 (-c class#method) : 会 执行 指定 类 下 
指定 的 测试 方法 ， 同 样 多 个 方法 之 前 可 以 使 用 空格 分 开 并 列 指 定 ， 如 


以 下 指令 会 运行 testC_e 、testD_g。 


# adb shell uiautomator runtest A.jar - 


c com,.tencent.uiautotest.cC#testC_e 


c com.tencent.uiautotest.D#testD_g 


(4) [options]。[options] 用 以 指定 测试 过 程 的 特殊 参数 ， 比 如 后 台 
挂 起 测试 、 回 测试 过 程 传递 测试 参数 、 调 试 当 前 测试 用 例 或 者 dump 当 
前 xml 视 图 以 保存 现场 进行 后 续 分 析 ， 具 体 的 用 法 见 表 5-1。 


表 5-1 ”UIAutomator 执 行 options 参 数 解 析 


选项 名 称 功能 描述 


指定 后 台 挂 起 运行 ， 若 设 有 该 参数 ， 通 过 adb shell 执行 的 UIAutomator 在 设备 断 开 连 
接 的 时 候 就 会 停止 运行 ， 使 用 该 参数 的 效果 等 价 于 使 用 “&” 挂 起 

给 执行 过 程 指定 参数 ， 以 键 值 对 的 方式 动态 封装 成 Bundle 供 测试 过 程 使 用 ， 在 
UiAutomatorTestCase 中 使 用 ee 可 获得 ， 可 以 多 项 指定 

本 质 上 和 上 面 的 -e 是 一 样 的 用 法 ， 其 特别 的 地 方 在 于 debug 为 UIAutomator 指令 中 的 
保留 字 ， 指 定 该 参数 可 以 打开 UIAutomator 执行 过 程 的 调试 端口 ， 默 认 调 试 模 式 为 关闭 

dump 当前 界面 的 xml 至 文件 中 ,通常 用 于 保留 当前 页 面 供 调 试 分 析 ，file 为 保存 的 文 
件 路 径 ， 不 指定 时 默认 为 /storage/sdcard0/window_dump.xml 


--nohup 


-e <key> <value> 


-e debug [truelfalse] 


dump [fle] 


1.UiAutomatorlestCase 


作为 所 有 测试 用 例 的 超 类 ，UiAutomatorTestCase 继 承 于 


junit.framework.TestCase， 遵 循 setUp、test、tearDown 的 测试 流程 ， 支 


持 断 言 使 用 ， 负 责 基础 的 框 腑 文 持 ， 包 含 执行 过 程 的 参数 获 了 到、 实例 
获取 及 断言 使 用 。 对 应 API 解 析 如 下 : 


(1) 参数 获取 。UiAutomatorTestCase 参 数 获 取 API 见 表 5-2。 


表 5-2” UiAutomatorTestCase 人 参数 获取 API 


方法 及 说 明 


返回 值 


getParams() 
在 执行 UIAutomator 时 ， 可 以 使 用 -e <key> <value> 给 执行 过 程 指定 参数 ， 所 有 键 值 对 存储 于 
参数 Bundle 中 ， 在 测试 过 程 中 通过 getParams() 得 到 该 Bundle 


Bundle 


(2) 实例 获取 。UiAutomatorTestCase 实 例 获取 API 见 表 5-3。 


表 5-3 ”UiAutomatorTestCase 实 例 获 取 API 


返回 值 方法 及 说 明 


getUiDevice() 


UiDevice _ a i a 
取得 当前 设备 实例 ， 等 效 于 使 用 UiDevice.getInstance0 


getAutomationSupport() 
IAutomationSupport 取得 UIAutomator 实现 的 IAutomationSupport 实例 用 以 向 结果 添加 INSTRUMENTATION_ 
STATUS 标识 的 日 志 信 息 


(3) 流程 执行 。UiAutomatorTestCase 流 程 执行 API 见 表 5-4。 


表 5-4 _ UiAutomatorTestCase 流 程 执行 API 


返回 值 方法 及 说 明 
setup() 
void 测试 前 环境 准备 ， 在 同一 个 类 中 于 每 个 testCase 前 执行 ,一般 被 用 户 覆 写 ， 将 测试 时 的 初始 化 准 
备 放置 于 该 方法 内 进行 


返回 值 方法 及 说 明 
sleep(long ms) 
void -日 己 症 已 二 >z 全 Ac fr -人 sq 
休眠 指定 时 间 ， 等 效 于 使 用 SystemClock.sleep(long ms) 
tearDown() 
void 测试 后 收尾 工作 ， 在 同一 个 类 中 于 每 个 testCase 后 执行 一般 被 用 户 覆 写 ， 用 以 处 理 执行 结果 、 


保存 数据 、 还 原 测 试 前 环境 


(4) 断言 支持 。UiAutomatorTestCase 上 晰 言 支持 API 见 表 5-5。 


表 5-5_ UiAutomatorTestCase 疡 言 支 持 API 


返回 值 方法 及 说 明 


assertXXX() 系列 
继承 于 junit framework.Assert， 常 用 断言 来 检查 当前 的 测试 环境 状态 ， 如 果断 言 失败 ， 则 认为 
case 执行 失败 ，case 执行 中 断 ， 


void 


进入 tearDown0 


2.UiDevice 


UiDevice 用 来 与 测试 设备 进行 交互 ， 获 取 设 备 信息 、 发 送 操作 指令 
及 保存 截图 布局 等 状态 ， 根 据 其 API 功 能 的 不 同 ， 以 下 分 几 个 方面 简单 
介绍 其 常用 的 功能 。 


(1) 事件 操作 相关 。 辐 设备 发 送 按钮 点 击 事件 ， 封 装 了 部 分 党 用 
的 按钮 ， 但 所 有 按钮 事件 都 可 以 通过 pressKeyCode (int keyCode) 这 个 
方法 来 等 效 指定 ， 见 表 5-6 。 


表 5-6 ”UiDevice 事 件 操作 API 


返回 值 方法 及 说 明 


pressBack() / pressHomel /pressMenu() / pressSearch() 


boolean es Ep 
单 击 返 回 键 / Home 键 / 菜单 键 /搜索 键 
pressKeyCode(int keyCode) 

boolean 


问 设 备 发 送 事 件 keyCode， 具 体 事 件 可 参见 KeyEvent 


(2) 屏幕 操作 相关 。 疝 设备 发 送 屏幕 操作 事件 ， 包 含 点 击 、 拖 
点、 修改 设备 屏幕 状态 〈 亮 来 屏 、 屏 幕 方向 ) ， 其 中 双击 可 以 使 用 
click 进 行 组 合 ， 多 个 点 连续 滑动 可 以 使 用 swipe (Point[]jsegments，int 


segmentSteps) ， 见 表 5-7。 


表 5-7 UiDevice 屏 幕 操 作 API 


返回 值 方法 及 说 明 
Gl click(int x, int y) 
oolean i A Rs i 
单 击 屏幕 坐标 点 (x,.y)， 坐 标 原 点 从 屏幕 左上 角 开 始 
drag(int startX. int startY., int endX, int endY. int steps) 
boolean 。 i ee 
从 (startX, startY) 问 (endX. endY ) 拖 电 ， 步 长 为 steps 
( 续 ) 
返回 值 方法 及 说 明 
swipe(int startX, int startY, int endX, int endY, int steps) 
boolean i es i 
从 (startX，startY) 问 (endX，endY) 滑动 ， 步 长 为 steps 
swipe(Point[] segments, int segmentSteps) 
boolean 按 住 不 动 顺 序 完成 点 间 的 滑动 ， 步 长 为 segmentSteps 
多 个 点 之 前 连续 滑动 可 以 使 用 该 API 来 实现 
sleep() 
Voli Si 汪 EVA 
设备 灭 屏 ， 进 入 休眠 状态 
wakeUp() 
void A 
唤醒 设备 ， 一 般配 合 isScreenOn 查询 状态 进行 
. setOrientationLeft() / setOrientationNatural() / setOrientationRight() 
void a 上. 2 i be 
设置 屏幕 向 左旋 转 90 度 /恢复 自然 角度 / 向 右 旋转 90 度 


(3) 快捷 开关 相关 。 封 装 Android 通 用 快捷 操作 ， 包 含 打 开通 知 
` 快速 设置 、 最 近 任 务 栏 ， 其 并 非 通过 模拟 弄 面 点 击 ， 而 生 通 过 服 


务 事件 调用 ， 所 以 对 不 同 的 ROM 都 有 较 好 的 兼容 性 ， 推 荐 使 用 ， 见 表 
D-8。 


表 5-8 UiDevice 快 捷 开 关 API 


返回 值 方法 及 说 明 
bool pressRecentApps () 
oolean re ee A 
打开 最 近 任 务 界面 (多 任务 切换 页 面 ) 
openNotification () 
boolean ek 
打开 通知 栏 
bool openQuickSettings () 
oolean i ep 
打开 快捷 设置 栏 


(4) 设备 截图 & 监 听 相 关 。 截 图 可 指定 缩放 比例 用 户 截图 质量 ， 
质量 越 高 ， 需 要 的 时 间 越 长 。 通 常用 于 保留 问题 现场 ， 而 注册 监听 则 
是 为 测试 过 程 置 入 界面 观察 者 ， 以 处 理 中 断 弹 窗 确保 测试 的 顺利 进 
行 ， 见 表 5-9 。 


表 5-9 _UiDevice 设 备 堆 图 & 监听 API 


返回 值 方法 及 说 明 
boal takeScreenshot(File storePath) 
oolean pi a ee ie 
截取 当前 屏幕 截图 ， 保 存 至 指定 文件 
takeScreenshot(File storePath. Hoat scale, int quality) 
boolean a ee ee " es 
截取 屏幕 截图 ，scale 为 缩放 比例 ，quality 为 截图 质量 
registerWatcher(String name, UiWatcher watcher) 
boolean etn ， me sp A 
注册 界面 观察 者 ， 以 处 理 中 断 弹 窗 ，name 作为 移 除 标识 
ec removeWatcher(String name) 
oolean A dd a i 
移 除 界面 观察 者 ，name 与 注册 时 对 应 


(5) 属性 获取 。UiDevice 属 性 获取 API 见 表 5-10 。 


表 5-10 ”UiDevice 属 性 获取 API 


返回 值 方法 及 说 明 
getDlisplayHelightO 
Int ee 
获取 当前 屏幕 高 度 
getDisplay Width() 
Int ER 
获取 当前 屏幕 宽度 
getCurrentActivityName() 
String tite 
获取 当前 Activity 名 
> getCurrentPackageName() 
String de 
获取 当前 页 面 所 属 应 用 包 名 
booj isScreenOn() 
oolean roi wo 
当前 屏幕 是 否 是 亮 起 状态 


(6) 视图 相关 。UiDevice 视 图 相关 API 见 表 5-11 。 


表 5-11 UiDevice 视 图 相关 API 


返回 值 方法 及 说 明 


dumpWindowHierarchy (File dest) 


void er 
dump 当前 窗口 视图 的 布局 到 指定 文件 


dumpWindowHierarchy(String fileName) 


void eri er 
dump 当前 窗口 视图 的 布局 到 指定 文件 
dumpWindowHierarchy(OutputStream out) 
void Ne 1 a wait 
dump 当前 窗口 视图 的 布局 到 指定 文件 
, getLastTraversedText() 
String ae yi sa pL 六 
获取 上 一 次 设置 的 text 内 容 
clearLastTraversedText() 
Vold 


I et 


清除 上 一 次 设置 的 text 内 容 


(7) 事件 等 待 。UiDevice 事 件 等 待 API 见 表 5-12 。 


表 5-12 ”UiDevice 事 件 等 待 API 


返回 值 方法 及 说 明 


waitForIdleO / waitForIdle(long timeout) 


void Ea i ac A st 
无 限时 等 待 当 前 应 用 空闲 / 等 待 应 用 空闲 ， 若 超时 则 不 再 等 竺 
waitForWindowUpdate(String packageName, long timeout) 
boolean 


等 待 指定 包 名 的 任意 窗口 更 新 ， 若 超时 则 不 再 等 待 


3.UiSelector 


UiSelector 用 来 描述 目标 控件 的 特征 ， 所 有 方法 调用 后 运 回 的 都 古 
UiSelector， 所 以 文 持 链 式 调用 填充 多 个 属性 ， 按 匹配 的 策略 大 体 可 以 
分 为 以 下 几 种 类 型 。 


(1) 完全 匹配 。UiSelector 完 全 匹配 API 见 表 5-13。 


表 5-13 UiSelector 完 全 匹配 API 


返回 值 方法 及 说 明 
Se checked(boolean val) / selected(boolean val) 
iSelector a ir my i RE 
目标 控件 是 否 可 以 被 勾 选 ， 一般 为 checkBox / 是否 被 选中 
ot enabled(boolean val) / clickable(boolean val) / longClickable(boolean val) 
iSelector i i ep 
目标 控件 是 否 可 用 /响应 点 击 / 响应 长 按 
it className(Class<T> type) / className(String className) 
iSelector Ee pp 
考 定 目标 控件 的 类 型 为 type 
we description(String desc) 
UiSelector pe pt 
上 § 定 目标 控件 的 描述 为 desc 
ie focusable(boolean val) / focused(boolean val) 
iSelector ee te dh 
目标 控件 是 否 可 被 聚焦 / 是否 正 被 聚焦 
tvefeat index(int index) 
iSelector ep A 
指定 目标 控件 的 下 标 为 index 
Te instance(int instance) 
iSelector i A i Re Rs i 
颖 定 目标 控件 为 符合 条 件 的 第 N 个 实例 ， 通 常 在 集合 遍历 时 使 用 
eee packageName(String name) 
iSelector A 
指定 目标 控件 的 包 名 为 name 
el text(String text) 
iSelector J i 
省 定 目标 控件 的 文案 为 text 
Ue scrollable(boolean val) 
iSelector Re Ia ee | 
目标 控件 是 否 可 以 深 动 ， 当 listView 为 一 页 时 实际 上 为 false 
resourceld(String 1d) 
UiSelector 


指定 目标 控件 的 JP 为 id 


(2) 部 分 包含 。UiSelector 部 分 包含 API 见 表 5-14。 


表 5-14 ”UiSelector 部 分 包含 API 


返回 值 方法 及 说 明 
descriptionStartsWith(String desc) 
UiSelector WE i 
指定 目标 控件 描述 以 desc 开头 
eet descriptionContains(String desc) 
1Selector ES 
指定 目标 控件 描述 包含 desc 
textStartsWith(String text) 
UiSelector pa I 
指定 目标 控件 文案 以 text 开头 
UiSel textContains(String text) 
iSelector i wp 
指定 目标 控件 文案 包含 text 


(3) 正则 匹配 。UiSelector 正 则 匹配 API 见 表 5-15。 


表 5-15  UiSelector 正 则 匹配 API 


返回 值 方法 及 说 明 
. textMatches(String regex) / descriptionMatches(String regex) 
UiSelector a 8 
指定 目标 控件 文案 /描述 匹配 regex 
a packageNameMatches(String regex) 
iSelector ee -As 用 - 
指定 目标 控件 包 名 匹配 regex 
a classNameMatches(String regex) 
UiSelector a oy 
指定 目标 控件 类 名 匹配 regex 
resourceIldMatches(String regex) 
UiSelegtos | ae 
指定 目标 控件 ID 匹配 regex 


(4) 父子 关系 。UiSelector 父 子 关 系 API 见 表 5-16。 


表 5-16 UiSelector 父 子 关 系 API 


返回 值 方法 及 说 明 


childSelector(UiSelector selector) 


UiSelector Si 3 人 
指定 目标 控件 拥有 孩子 节点 匹配 selector 
. fromParent(UiSelector selector) 
UiSelector 


指定 目标 控件 拥有 父 节点 匹配 selector 


4.UiObject 


UiObject 抽 象 的 程度 比较 高 ， 所 有 Android 基 础 控件 都 可 以 用 
UiObject 来 表示 ， 在 上 自动 化 过 程 中 用 以 完成 信息 获取 及 控件 交互 。 


(1) 属性 获取 。UiObject 属 性 获取 API 见 表 5-17。 


表 5-17 UiObject 属 性 获取 API 


返回 值 方法 及 说 明 
exists() 
boolean 控件 是 否 存 在 ， 控 件 不 会 null 时 不 代表 控件 存在 ， 需 要 调用 此 方法 才 
可 以 确认 控件 是 否 在 当前 页 面 ， 交 互 前 建议 先 调 用 此 方法 确认 
getBounds 
Raet getBounds() 


获得 控件 的 完整 边框 信息 ( 含 未 可 见 部 分 ) 


getVisibleBounds() 


Rect 获得 控件 的 可 见 边 框 信息 (不 可 见 部 分 无 效 ) 
Wii getContentDescription() 
_ 获得 控件 的 描述 信息 
String getPackageName() 
- 获得 控件 的 包 名 
bovilean isCheckable() / isChecked() 
控件 是 否 可 勾 选 /是 否 已 经 被 色 选 
( 续 ) 
返回 值 方法 及 说 明 
BUDE isFocusable() / isFocused() 
控件 是 否 可 聚焦 / 是否 为 当前 聚焦 
boolean EDD SD / a) . isLongClickableO /isScrollable() 
控件 是 否 可 用 /响应 点 击 /响应 长 按 / 可 滚动 
| isSelected() 
控件 是 否 已 经 被 选中 
Strinsg getText() 
_ 获取 控件 的 文案 


(2) 控件 获取 。UiObject 属 性 获取 API 见 表 5-18。 


表 5-18 ”UiObject 属 性 获取 API 


返回 值 


方法 及 说 明 


和 getChildCount() 
获取 孩子 控件 的 个 数 
Uiobject eetC hd UiSelector selector) 
在 孩子 节点 中 根据 selector 获取 对 应 控件 
a getFromParent(UiSelector selector) 
UiObject 


在 父 节点 ( 仅 一 级 ) 下 根据 selector 获取 对 应 控件 


(3) 操作 相关 。UiObject 相 关 操作 API 见 表 5-19 。 


返回 值 


表 5-19 ”UiObject 相 关 操 作 APTI 


方法 及 说 明 


click() / clickBottomRight() / clickTopLeft() 


boolean i es 
点 击 控件 中 间 / 右 下 角 / 左 上 角 
clickAndWaitForNewWindow(long timeout) 
boolean 点 击 控件 并 且 等 待 至 有 新 窗口 出 现 ， 如 果 超 时 间 内 有 新 窗口 出 现 则 继 
续 往 下 走 ， 如 果 没 有 ， 则 一 直 等 到 超时 后 继续 往 下 走 ， 强 烈 建议 使 用 
longClick() / longClickBottomRight() / longClickTopLeft() 
boolean ee i 
长 按 控件 中 间 / 右 下 角 / 左 上 角 
uc swipeDown(int steps) / swipeUp(int steps) 
oolean a re aes 
从 控件 中 间 向 下 滑动 /向 上 滑动 
setText(String text) / clearTextFiled() 
boolean 


设置 控件 文案 / 清除 控件 文案 (EditText) 


(4) 事件 等 待 。UiObject 事 件 等 待 API 见 表 5-20 。 


5.UiCollection 


UiCollection 继 承 于 UiObject， 用 于 表示 符合 同一 UiSelector 的 控件 
集合 ， 通 常用 于 集合 的 遍历 使 用 ， 较 于 UiObject 多 了 四 个 方法 ， 用 于 获 


表 5-20 ”UiObject 事 件 等 待 API 


se 方法 及 说 明 


waltForExlsts(long timeout) 
超时 时 间 内 等 待 控件 出 现 ， 超 时 后 则 不 再 等 竺 


boolean 


waitUntilGone(long timeout) 


boolea i Sp 
a 超时 时 间 内 等 待 控件 消失 ， 超 时 后 则 不 再 等 待 
. . » 品 
表 5-21 UiCollection 相 关 操 作 API 
返回 值 方法 及 说 明 
a getChildByDescription(UiSelector childPattern., String text) 
UiObject 


根据 childPattern 及 描述 匹配 返回 子 控件 

getChildByInstance(UiSelector childPattern, int instance) 

UiObject 根据 childPattern 匹配 ， 取 第 instance 个 实例 对 象 ， 同样 也 可 以 这 么 写 mUiCollection. 
getChild(new UiSelector.instance( 1 ) ) 


getChildByText(UiSelector childPattern, String text) 


UiObject a Be 
根据 childPattern 及 文案 匹配 返回 子 控件 


getChildCount(UiSelector childPattern) 
获得 匹配 childPattern 的 控件 个 数 


int 


6.UiScrollable 


UiScrollable 继 承 于 UiCollection， 用 来 表示 可 深 动 控件 。 通 常用 于 
屏幕 之 外 的 控件 检索 ， 封 疾 了 深 动 操作 及 自动 滚动 查找 控件 的 操作 ， 
在 实际 的 目 动 化 过 程 中 还 是 比较 实用 的 。 


(1) 状态 相关 。UiScrollable 状 态 API 见 表 5-22。 


表 5-22 ”UiScrollable 状 态 API 


返回 值 方法 及 说 明 


getMaxSearchSwipes() / set MaxSearchSwipes(int swipes) 


证 获取 /设置 检索 最 大 滚动 次 数 
void setAsHorizontalList() / setAsVerticalList() 
设置 为 水 平 列表 /垂直 列表 
voi setSwipeDeadZonePercentage(double percentage) 


设置 击 盲区 的 百分比 ， 肉 认 值 0.1 
(2) 操作 相关 。UiScrollable 相 关 操 作 API 见 表 5-23。 
(3) 控件 获取 。UiScrollable 相 关 操 作 API 见 表 5-24。 


表 5-23 ”UiScrollable 相 关 操 作 API 


返回 值 方法 及 说 明 
flingBackward() / flingForward() 

boolean ee 一 本 
〖 速 各 前 /向 后 滑动 (step =5 )， 较 于 scroll 方法 比较 快 

Bod flingToBeginning(int maxSwipes) / flingToEnd(int maxSwipes) 

oolean ee ee ho 

快速 飞 滑 至 开始 /结束 ， 最 大 滑动 次 数 为 maxSwipes 
scrollBackward() / scrollForward() 

boolean eet rt ee 
以 默认 速度 向 前 / 回 后 滑动 (step = 55 ) 

Bo scrollToBeginning(int maxSwipes) / scrollToEnd(int maxSwipes) 

oolean E21 二 FFE 十 于 机 J | =| SH hh Yh wk{y > 

以 默认 速度 滚动 至 开始 / 结束， 最 大 滑动 次 数 为 maxSwipes 
scrollDescriptionIntoView(String text) 

boolean i po rt SI EAE 
滚动 至 描述 为 text 的 控件 ， 如 果 没 有 ， 则 遍历 停留 在 列表 尾部 
scrollIntoView(UiSelector selector) 

boolean a a a i 
滚动 至 匹配 selector 的 控件 ， 如 果 没 有 ， 则 遍历 停留 在 列表 尾部 
scrollTextIntoView(String text) 

boolean CO was NL- Ne es 
深 动 至 文案 为 text 的 控件 ， 如 果 没 有 ， 则 遍历 停留 在 列表 尾部 


表 5-24 UiScrollable 相 关 操 作 APTI 


返回 值 方法 及 说 明 


getChildByDescription(UiSelector childPattern, String text, boolean allowScrollSearch) 
UiObject 查找 描述 为 text 且 匹 配 childPattern 的 控件 ，allowScrollSearch 表示 是 否 自 动 滚动 查 
询 ， 默 认为 tue， 为 false 时 只 查找 当前 页 面 

getChildByInstance(UiSelector childPattern. Int instance) 

查找 实例 编号 为 instance 且 匹 配 childPattern 的 控件 


UiObject 


getChildByText(UiSelector childPattern, String text, boolean allowScrollSearch) 
UiObject 查找 文案 为 text 上 且 匹 配 childPattern 的 控件 ，allowScrollSearch 表示 是 否 自动 深 动 查 
询 ， 默 认为 tue， 为 false 时 只 查找 当前 页 面 


7.Configurator 


Configurator 是 UIAutomator 有 的 配置 类 ， 主 要 用 于 获取 设置 测试 过 程 
中 的 超时 等 待 参数 ， 通 过 修改 参数 可 以 调整 操作 速率 ， 更 加 贴近 想 要 
模拟 的 用 户 操作 场景 。 配 置 设置 API 见 表 5-25 。 


表 5-25 配置 设置 API 


返回 值 方法 及 说 明 
1 getActionAcknowledgmentITimeoutO 
ong i siEEioy ze i 
上 获取 当前 通用 动作 的 超时 时 间 
getKeyInjectionDelay() 
long A vires 
获取 当前 键盘 输入 的 超时 时 间 
1 getScrollAcknowledgmentTimeout() 
ong ge es 
获取 当前 滚动 动作 的 超时 时 间 


返回 值 方法 及 说 明 
1 getWaitForldleTimeout() 
ong er ee 和 
获取 当前 等 待 应 用 空闲 超时 时 间 
1 getWaitForSelectorTimeout() 
ong St es 4 更 
获取 当前 控件 匹配 的 超时 时 间 
setActionAcknowledgmentTimeout(long timeout) 
Configurator 和 
设 定 通用 动作 的 超时 时 间 
setKeyInjectionDelay(long delay) 
Configurator Sy 3 
设 定 键盘 输入 的 超时 时 间 
setScrollAcknowledgmentTimeout(long timeout) 
Configurator de > 
设 定 滚动 动作 的 超时 时 间 
setWaitForIdleTimeout(long timeout) 
Configurator ee ei ne 
设 定 等 待 应 用 空闲 超时 时 间 
En 站 setWaitForSelectorTimeout(long timeout) 
onfigurator rant 
设 定 控件 匹配 的 超时 时 间 


8.UiWatcher 


UiWatcher 是 interface 作 为 界面 观察 者 处 理 测试 过 程 所 有 的 弹 窗 中 
断 ， 接 口 仅 存 在 一 个 方法 即 checkForCondition， 实 现 后 调用 UiDevice 进 
行 注册 ， 其 生命 周期 是 从 注册 的 那 一 刻 开 始 ， 直 至 测试 结束 或 者 调用 
UiDevice 进 行 移 除 。 如 有 果 用 户 想 防止 突然 弹出 的 Crash 弹 杠 、 半 钟 、 电 
话 等 阻塞 测试 的 执行 ，UiWatcher 还 是 非常 实用 的 选择 。 对 应 API 说 明 
见 表 5-26。 


表 5-26 ”UiWatcher 对 应 API 说 明 


返回 值 方法 及 说 明 
checkForCondition() 
当 进 行 控 件 匹 配 而 当前 又 没有 任何 匹配 控件 时 ，framework 会 遍历 所 有 注册 的 UiWatcher， 
回调 此 方法 ， 以 处 理 不 可 预料 的 弹 框 或 者 页 面 导致 测试 中 断 。 如 果 回 调 中 找到 了 匹配 的 情况 
并 予以 处 理 ， 则 返回 true; 如 果 未 有 任何 匹配 (情况 在 预料 之 外 )， 则 返回 false 


boolean 


5.3 ”UIAutomator 实 战 


了 解 完 UIAutomator 的 原理 及 常用 API 后 ， 就 可 以 动手 开始 我 们 的 
自动 化 进程 了 。 接 下 来 我 们 通过 UIAutomator 在 实际 测试 运用 过 程 中 的 
一 些 案例 及 遇 到 的 问题 解决 ， 来 详细 解说 这 个 框架 的 一 些 设计 思想 及 
运用 技巧 (笔者 建议 提前 安装 ADT Bundle 开 发 环境 ， 以 下 开发 均 基 于 
此 环境 进行 ， 可 以 移 步 https://developer.android.com/intl/zh- 


cn/sdk/index.html 进行 下 载 及 安装 学 习 ) 


5.3.1_UIAutomator 快 速 上 手 


UIAutomator 测 试 项 目的 整体 流程 大 体 上 可 以 分 为 以 下 几 个 步 桑 。 
(1) 分 析 应 用 UI 界面 元 素 ， 获 取 元 素 属性 。 
(2) 创建 测试 用 例 ， 编 码 模拟 用 户 操作 过 程 。 


(3) 编译 测试 代码 为 测试 jar 包 ，push 至 终端 。 


(4) 在 设备 上 运行 测试 ， 查 看 测试 结 
(5) 修改 发 现 的 BUG， 修 复 并 重新 测试 。 
1. 界 面 元 素 获 取 


UIAutomator 提 供 了 一 个 界面 解析 器 供 开 发 者 使 用 ， 位 于 Android 
SDK/tools/ 目 录 下 ， 建 议 配 置 至 系统 环境 变量 Path 中 ， 在 后 续 开发 过 程 
经 常用 到 。 打 开 UIAutomatorVeiwer 后 ， 可 以 使 用 两 种 方法 进行 界面 解 
析 : 一 是 使 用 UIAutomator runtest dump 保 存 下 来 的 xml 文 件 ， 二 是 连接 
设备 后 直接 点 击 左 上 角 Device screenshot 获 取 当 前 界面 的 解析 结果 。 其 
中 方法 二 较为 常用 。 


如 图 5-5 所 示 ， 左 边 为 界面 导航 器 ， 可 以 使 用 鼠标 单 击 的 方式 选中 
目标 控件 。 右 上 方 为 控件 树 ， 在 此 可 以 看 到 控件 之 间 的 层级 关系 及 当 
前 控件 在 控件 树 中 的 位 置 。 右 下 方 为 当前 控件 的 详细 信息 ， 在 此 可 以 
获取 目标 控件 的 属性 信息 以 供 编码 使 用 。 


二 口 4 下 午 221 


4 (0) FrameLayout [0.01[1080,1920] 
4 (0) LinearLoyout [0.0][1080,1920) 
4 四 LinearLayout [0,0][1080,1920] 
a (0) LinearLayout [0,.0][1080,1920) 
4 (0) View iD0l[10801920] 
(tO) View {0,0][1080,225] 
b (1} LinearLayout {0.225)f1080,429] 
bp (2) LinearLayout [0,.42911080,591] 
bb (3] LinearLayout [0,591][1080,753] 
4 (4] Lineartayout [0,753][1080,915] 
4 (0) LinearLayout [60.753ji1020.915] 
(0) ImageView [60.793][132.870] 
a (1) RelativeLayout [174,797][876,.€ 
(Dj TextViewr 近 时 电话 [174,797 
{2} Lineartayout [876,753][1020,9 
4 (5] Lineartayout [0.915][1080,1119] 


Node Detail 

index 0 

text 妾 些 谍 证 

resource-id com.tencent. qrom:id /tide 
class android widgetTextVieywy 
package comandroid,settings 
content-desc 

chackable false 

checked false 

clickable false 

enabled true 

focusable false 


focused false 


scrollable false 
* 医 


图 5-5 ”UIAutomatorViewer 界 面 


2. 项 目 环境 配置 


UIAutomator 自 动 化 项 目 从 创建 Java 项 目 开始 〈 非 Android 项 目 ) ， 
其 所 需要 依赖 的 库 有 android.jar 及 uiautomatorjar， 均 位 于 /Android 
SDKmplatforms/android-xx/ 目 录 下 ， 其 中 xx 表示 目标 API Level， 建 议 使 
用 19 以 上 (新 增 UiSelector.resourceId 系 列 方法 ， 方 便 控 件 抓 取 时 使 
用 ) 。 


配置 好 环境 后 的 Libraries 情 况 如 图 5-6 所 示 。 


| | Java Build Path 
Resource 
Builders 
java Build Path JARs and class folders on the build path: 
Java Code Style 匠 androidjar - D:\Program Files\ADT\sdk\platforms\android-19 Add JARs... 
b> Java Compiler BO uiautomatorjar - D:\Program Files\ADT\sdk\platforms\android-19 


Java Editor » a JRE System Library [OSGi/Minimum-1.2] 
Javadoc Location 


Source | [了 3 Projects| 到 Libraries | Order and Export 


Add External JARs... 


Add Variable... 


Project References 
Run/Debug Settings Add Library... 
Task Tags 
Validation 


Add Class Folder... 


Add External Class Folder... 


OK Cancel 


图 5-6 ”配置 好 环境 后 的 Libraries 情 况 


3. 测 试用 例 编写 


我 们 以 测试 系统 设置 目 动 休眠 时 间 寅 略 是 否 有 效 为 例 ， 写 一 个 测 
试用 例 来 完成 自动 化 测试 。 页 面 的 切换 操作 顺序 如 图 5-7 所 示 ， 先 打开 
系统 设置 页 面 ， 然 后 进入 显示 页 面 ， 再 单 击 休眠 按钮 ， 选 择 相应 的 休 
眼 时 间 来 完成 设置 。 对 于 UIAutomator 的 用 例 编写 ， 有 几 个 基础 规范 如 
下: 


:每 个 用 例 都 继承 于 UiAutomatorTestCase， 可 见 域 为 public 。 
:setUp () 于 每 个 测试 用 例 前 执行 ， 适 于 用 作 环 境 准 备 。 


tearDown () 于 每 个 测试 用 例 后 执行 ， 适 用 于 数据 收集 及 环境 恢 


ll 


一 个 类 可 以 有 多 个 测试 用 例 ， 用 例 之 间 不 建议 耦合 ， 执 行 期 间 为 
无 序 执行 。 


QCD 17.47 


其 他 连接 方式 
自动 旋转 屏幕 


夜间 护 眼 
桌面 和 锁 屏 防止 黑暗 环境 下 亮 屏 刺眼 


休眠 


图 5-7 系统 设置 目 动 休眠 时 间 用 例 ”页 面 跳 转 
依据 上 述 的 测试 顺序 ， 编 码 得 到 测试 用 例如 代码 清单 5-10 所 示 。 
代码 清单 5-10 “系统 目 动 休眠 沫 略 测 试用 例 


public class HelloUiAutomator extends UiAutomatorTestCase { 
private static final String TAG = HelloUiAutomator.class.getSimpleName(); 
private static final String FORMAT_LOG = ">>> %s [%s] %s"; 
private static final SimpleDateFormat DATE_FORMAT = new SimpleDateFormat( 
"yyyy-HH-DD hh:mm:ss"); 
private static final long TIME_ OUT_FOR_EXISTS = 5 * 1000L; 
protected void setUp() throws Exception { 
log(TAG, "setUp of " + getName()); 
super .setUp(); 


} 
ys 
* 测试 场景 ; 验证 自动 休眠 设置 是 否 有 效 


<br> 
* 操作 过 程 : 


<br> 


* > 打开 系统 设置 ， 设置 自动 休眠 时 间 为 


30S<br> 


* > 休眠 


30S， 检 查 屏幕 状态 


<br> 
* 预期 结果 : 屏幕 为 灭 屏 状态 


*/ 

public void testSetScreenoffTime() throws IOException, 
UiOobjectNotFoundException, RemoteException { 

// 打开 系统 设置 页 再 


Runtime.getRuntime().exec("monkey -p com,android,settings -v 1"); 
// 找到 滚动 列表 : 这 里 以 包 名 、 


TesourceId 作 为 条 件 表示 系统 设置 滚动 列表 


Uiscrollable mSettingList = new UiScrollable(new UiSelector() 
.packageName("com.android,.settings") 
.resourceId("android:id/list")); 

mSettingList.waitForExists(TIME OUT_FOR_EXISTS); 

assertTrue("System setting list not exists", mSettingList.exists()); 

// 获取 显示 控件 并 点 击 进入 显示 设置 : 使 


UiScrollable 获 取 子 控件 会 自动 滚动 寻找 


log(TAG, "Enter display setting page"); 
Uiobject mDisplayEntry = mSettingList.getchildByText( 
new UiSselector().resourceIdMatches(".*title")，" 显 示 


"); 
assertTrue("Display setting entry not exists", 
mDisplayEntry.exists() && mDisplayEntry.isEnabled()); 
mDisplayEntry.clickAndwaitForNewwindow(); 
// 单 击 休 眼 按钮 进入 设置 


log(TAG, "Enter Sleep timeout setting page"); 
Uiobject mSleepTimeEntry = new Uiobject( 
new UiSelector().textContains(" 休 了 眠 


")); 
assertTrue("Sleeping timeout setting entry not exists", 
mSleepTimeEntry.exists() && mSleepTimeEntry.isEnabled()); 
mSleepTimeEntry.clickAndwaitForNewWindow!( ); 
// 单 击 设置 为 


30S 超 时 


log(TAG, "Set Sleepling timeout to 30s"); 
Uiobject mTargetTimeout = new Uiobject( 
new UiSelector() .textMatches("30 秒 


130s")); 
assertTrue("Can't find target timeout for setting", 
mTargetTimeOut.exists() && mTargetTimeOut.isEnabled()); 
mTargetTimeout .clickAndwaitForNewwindow( ); 


} 


// 检验 结果 


log(TAG, "Sleep 30s for checking auto sleep"); 

UiDevice mUiDevice = getUiDevice(); 

SystemClock.sleep(30 * 1000); 

assertFalse("Auto Sleep didn't work", mUiDevice.isScreenon()); 


protected void tearDown() throws Exception { 
log(TAG, "tearDown of " + getName()); 
Super .tearDown( ) ， 
} 
A/ 
* 返回 当前 系统 时 间 
* @return yyyy-HH-DD hh:mm:ss 
4 


private static String getCurTime() { 

return DATE_FORMAT.format(new Date(System.currentTimeMillis())); 
} 
/A/** 


* 输出 日 志 


* @param tag TAG 
* @param message 消息 


A 
private static void log(String tag, String message){ 
System.out.println(String.format( 
FORMAT_LOG, getcCurTime(), tag, message)); 
} 


4. 测 试 项 目 编译 


编写 完 测 试用 例 后 ， 我 们 需要 将 代码 编译 成 jar 包 以 供 测 试 使 用 ， 


UIAutomator 上 自动 化 测试 项 目 编译 使 用 的 是 ant (由 Apache 提 供 的 将 软件 
编译 、 测 试 、 部 闭 等 步 又 联系 在 一 起 加 以 目 动 化 的 一 个 工具 ，ADT 
Bundle 环 境 中 已 经 集成 ， 使 用 Eclipse 环境 可 以 移 步 http:Want.apache.org/ 
下 载 ) 编译 方式 。 我 们 此 前 创建 的 只 是 普通 的 Java 项 目 ， 所 以 在 首次 编 


译 的 时 候 需 要 为 项 目 添加 ant 编 译 脚本 ， 在 Android 指 令 中 已 经 目 市 了 这 
方面 的 文 持 ， 指 令 如 下 面 的 代码 所 示 。 


> android list 
id: 12 or "android-19" 
Name: Android 4.4 
Type: Platform 
API level: 19 
Revision: 1 
Skins: HVGA, QVGA, WQVGA400, WQVGA432, WSVGA, WVGA800 (default) 
ABIS : armeabi-v7ia 


> android create uitest-project -n projectName -t targetID -p projectPath 


targetID: 编译 使 用 的 Android Level 在 本 机 上 对 应 的 ID， 可 使 用 


android list 查 看 。 


-ProjectName: 编译 目标 项 目 名 称 ， 也 是 对 应 生成 的 jar 包 名 称 。 


:projectPath: 编译 目标 项 目 根 目录 路 径 。 


执行 完 以 上 指令 后 ， 在 项 目 路 径 下 会 新 增 三 个 文件 ， 如 图 5-8 所 


修 ° 


4 > HelloUiAutomator 


4 | 过 src 
4 岂 com:tencent.ulautomator 
国 HelloeUiAutomatorjava 
到 Referenced Libraries 
mi JRE System Library 
可 build.xml 
国 local.properties 


国 project.properties 


图 5-8 生成 UIAutomator 项 目 后 工程 目 永 结构 


上 图 所 示 的 文件 ， 具 体 说 明 如 下 : 


:build.xml: ant 编 译 脚本 ， 为 /Android SDK/tools/ant/build.xml 的 副 | 
本 o 


local.properties: 存储 本 机 SDK 路 径 ， 符 SDK 目 孙 迁 移 可 在 此 做 对 
应 修改 。 


:project.properties: 存储 编译 使 用 的 API Level ， 如 target=android- 
19。 


至 此 ， 可 以 直接 使 用 ant 对 项 目 执行 build 的 操作 (在 build.xml 文 件 
上 单 击 右键 一 Run As~ Ant Build， 或 者 在 终端 cd 至 build.xml 所 在 目录 ， 
执行 ant build 指 令 ) ， 完 成 后 在 项 目的 bin 目 录 下 即 可 以 看 到 以 项 目 名 称 
命名 的 jar 包 ， 即 为 最 终 测试 使 用 的 产物 。 


5. 测 试用 例 执行 


完成 项 目 编译 后 ， 束 可 以 连接 设备 进行 测试 了 ， 过 程 分 为 两 步 : 
先 将 所 需 的 jar 包 推送 至 目标 /data/local/tmp 目 录 下 ， 然 后 指定 要 测试 的 
用 例 开 始 执行 测试 过 程 。 


>adb push HelloUiAutomator.jar /data/local/tmp 
378 KB/s (2716 bytes in 0.007S ) 
>adb shell uiautomator runtest HelloUiAutomator.jar 


INSTRUMENTATION_STATUS : 
INSTRUMENTATION_STATUS : 


com.tencent .UIautomator . 


INSTRUMENTATION_STATUS : 
INSTRUMENTATION_STATUS : 
INSTRUMENTATION_STATUS : 
INSTRUMENTATION_STATUS : 


INSTRUMENTATION_STATUS 


>>> 
>>> 
>>> 
>>> 


2015-11-24 
2015-11-24 
2015-11-24 
2015-11-24 
>>> 2015-11-24 
>>> 2015-11-24 
INSTRUMENTATION _sTATUS: 
INSTRUMENTATION_STATUS: 
INSTRUMENTATION_STATUS: 
INSTRUMENTATION_STATUS: 
INSTRUMENTATION_STATUS: 
INSTRUMENTATION_STATUS: 
INSTRUMENTATION_STATUS_ 
INSTRUMENTATION_STATUS: 


Test results for Watche 
Time: 40.75 
OK (1 test) 


INSTRUMENTATION_STATUS 


numtests=1 

stream= 

HelloUiAutomator: 

id=UiAutomatorTestRunner 

test=testSetScreenoffTime 

class=com.tencent.uiautomator.HelloUiAutomator 

current=1 

CODE: 1 
[HelloUiAutomator] 
[HelloUiAutomator] 
[HelloUiAutomator] 
[HelloUiAutomator] 
[HelloUiAutomator] 
[HelloUiAutomator] 
numtests=1 
stream=. 
id=UiAutomatorTestRunner 
test=testSetScreenOoffTime 
class=com.tencent.uiautomator.HelloUiAutomator 
current=1 

CODE: 0 
stream= 

rResultPrinter=. 


SetUp of testSetScreenoffTime 
Enter display setting page 

Enter sleep timeout setting page 
Set sleeping timeout to 30s 

Sleep 30s for checking auto Sleep 
tearDown of testSetScreenoffTime 


CODE: -1 


在 执行 过 程 中 ， 会 有 instrumentation 及 我 们 自 定义 的 Log 进 行 输 


出 ， 按 执行 流程 输出 的 顺序 为 : 执行 前 后 instrumentaion 输 出 执行 状态 
信息 (使 用 IautomationSupport 输 出 的 日 志 也 会 在 此 展示 ) ， 中 间 夹 着 
执行 过 程 中 我 们 输出 的 日 志 。 对 于 日 志 信 息 的 几 个 字段 ， 信 息 意义 如 
下 : 


numtests=1: 本 次 用 例 执行 的 总 用 例 数 为 1。 


本 次 执行 着 的 ID 为 


:id=UiAutomatorTestRunner: 


UiAutomatorlestRunner ° 


当前 执行 用 例 方 法 名 为 


‘test=testSetScreenOffTime: 


testSetScreenOffTime ° 


:class=com.tencent.uiautomator.HelloUiAutomator: 当前 执行 用 例 的 


类 名 为 com.tencent.uiautomator.HelloUiAutomator 。 


:current=1: 当前 执行 用 例 的 序号 为 1 。 


.Test results for WatcherResultPrinter=.: 本 次 总 的 执行 结果 ， 对 应 用 
例 顺序 ，“.”* 表 示 用 例 执行 成 功 ，“F” 表 示 用 例 执行 失败 ，“EE” 表 示 执 行 
用 例 出 错 。 


5.3.2” UIAutomator 设 计 思 想 


UIAutomator 框 染 本 映 比较 人 简单， 留 给 开发 人 员 目 由 发 挥 的 余地 也 
比较 大 。 我 们 可 以 根据 自身 的 需求 ， 对 其 进行 二 次 封装 改造 ， 但 其 目 
身 的 某 些 用 例 设 计 思 想 ， 还 古 比 较 优 秀 、 实 用 的 ， 建 议 在 后 续 的 开发 
过 程 中 继续 保留 。 


1. 断 言 中 断 式 用 例 设计 


UIAutomator 用 例 继承 于 junit,framework.Assert， 在 测试 过 程 中 可 
以 使 用 断言 对 检查 点 进行 校 验 。 实 际 上 Junit 的 用 例 设计 思想 也 是 这 样 
的 ， 默认 用 例 顺 序 执行 完毕 表示 用 例 执 行 成 功 ， 在 执行 过 程 中 有 异常 
抛 出 则 认为 用 例 执行 失败 。 对 于 测试 用 例 的 设计 来 讲 ， 就 需要 在 关键 
的 检查 点 插入 校 验 状 态 的 断言 ， 一 旦 发 现 与 预期 逻辑 不 符 ， 用 例 执行 
必定 失败 ， 则 抛 出 异常 ， 中 断 当 前 用 例 的 执行 。 


中 断 式 的 用 例 设计 思想 与 顺序 式 的 写法 有 什么 不 同 呢 ? 我 们 通过 
上 面 检 验 休眠 设置 的 例子 来 大 体 摘 述 一 下 两 种 思想 的 代码 写法 。 对 于 
用 例 中 描述 的 场景 为 : 打开 设置 - 单 击 显示 按钮 -~ 单 击 休眠 按钮- 单 
击 30 秒 按钮 ， 在 这 个 过 程 中 ， 我 们 需要 确保 这 三 个 单 击 的 按钮 一 定 存 
在 ， 否 则 用 例 肯 定 会 执行 失败 。 


顺序 式 的 写法 如 代码 清单 5-11 所 示 ， 可 以 看 到 每 个 check Point 都 加 
入 了 一 个 if 分 文 判 断 ， 代 码 整体 上 看 比较 了 见长 ， 藤 套 较 多 ， 便 于 理解 
但 不 便于 阅读 及 后 期 维护 。 


代码 清单 5-11 顺序 式 写法 代码 


if(mSettingList.isExists())t 
mDisplayEntry = mSettingList.getchildByText(" 显 示 


"); 
if(mDisplayEntry.isExists())t{ 
mDisplayEntry.clickAndwaitForNewwindow( ) ， 
if(mSleepTimeEntry.isExists())t{ 
mSleepTimeEntry.clickAndwaitForNewwWindow( ); 
if(mTargetTimeOut.isExists()){ 
mTargetTimeOut.click(); 
SystemClock.sleep(3 * 1000); 
if(!mUiDevice.isSscreenon()) 
System.out.printjn("Test success"); 
else throw new Exception("Device is Screen on"); 


elsef{ 
throw new Exception("TargetTimeout not found"); 
} 
} 
elsef{ 
throw new Exception("SleepTimeEntry not found"); 
} 
} 
elsef{ 
throw new Exception("DisplayEntry not found"); 
} 


else throw new Exception("SettingList not found"); 


再 来 看 中 断 式 的 代码 ， 风 格 完 全 不 一 样 ， 所 有 的 if 判 断 分 支 都 采 
用 断言 进行 蔡 换 ， 不 用 显示 抛 出 异常 ， 没 有 代码 幅 套 ， 干 姜 、 舒 适 ， 
便于 阅读 ， 操 作 步 又 之 间 可 以 用 段落 分 开 ， 整 体 代码 逻辑 比较 紧 竣 ， 
方便 后 续 代码 维护 ， 如 代码 清单 5-12 所 示 。 


代码 清单 5-12 中断 式 写法 代码 


assertTrue("SettingList not found", mSettingList.isExists()); 
mDisplayEntry = mSettingList.getchildByText(" 显 示 


了 
assertTrue("DisplayEntry not found", mDisplayEntry.isExists()); 
mDisplayEntry.clickAndwaitForNewwindow( ); 
assertTrue("SleepTimeEntry not found", mSleepTimeEntry.isExists()); 
mSleepTimeEntry.clickAndwaitForNewwWindow( ); 
assertTrue("TargetTimeOut not found", mTargetTimeOut.isExists()); 
mTargetTimeOut.click(); 
SystemClock.sleep(3 * 1000); 
assertFalse("Device is Screen on", mUiDevice.isScreenOn()); 


2.setUp 、 tearDown 


UIAutomator 用 例 继承 于 junit.framework.TestCase， 其 中 有 两 个 方 
法 : setUp 和 tearDown。 从 字面 上 来 看 非常 好 理解 ， 在 每 个 测试 方法 执 
行 之 前 都 先 执行 stUp， 在 每 个 测试 方法 执行 之 后 执行 tearDown， 比 如 
测试 类 中 存在 着 方法 testA () 、testB() ， 则 执行 的 顺序 是 setUp 0 


>testA () —»tearDown () —setUp () ~—testB () —»tearDown () 。 


setUp 通 常用 于 做 测试 用 例 前 的 环境 准备 及 状态 记录 ， 如 开局 
LOG、 关 闭 Wi-Fi 等 。 对 于 上 面 的 路 径 大 家 可 能 会 存在 这 样 的 疑问 ， 由 
于 同一 个 类 中 的 所 有 测试 用 例 执 行 的 都 是 同一 个 setUp 方 法 ， 那 么 春 不 
同 的 用 例 需 要 不 同 的 前 置 条 件 ， 有 没有 什么 办 法 满足 呢 ? 答案 征 肯 定 
的 。 一 方面 ， 我 们 可 以 在 setUp 方 法 中 通过 getName () 来 获取 当前 执 
行 用 例 的 名 称 ， 以 此 来 区 分 不 同 的 用 例 需 要 执行 的 前 置 操作 ， 男 一 方 


面 ， 建 议 把 用 例 按 模块 进行 分 类 ， 同 一 类 中 的 用 例 前 置 条 件 保持 基本 
一 致 ， 部 分 不 同 的 细节 ， 也 可 以 放 在 具体 的 用 例 里 进行 调节 。 


对 于 同一 测试 类 中 的 不 同方 法 ， 若 测试 的 环境 准备 只 需要 做 一 
次 ， 也 可 以 在 类 中 增加 标志 符 ， 配 合 setUp 只 做 一 次 初始 化 操作 ， 比 如 
添加 boolean hasInit 初 始 化 为 false， 仪 当 hasInit 为 false 时 才 执 行 init， 并 
在 执行 完成 后 将 其 置 为 rue， 以 此 实现 类 前 初始 化 操作 。 


tearDown 方 法 通常 用 于 做 测试 执行 后 的 结果 收集 及 环境 恢复 。 通 
常 结果 的 收集 需要 放 在 用 例 执行 的 最 后 ， 但 在 执行 用 例 的 过 程 中 ， 可 
能 会 由 于 断言 失败 或 者 执行 异常 抛 出 等 中 断 了 当前 的 测试 ， 那 么 结果 
收集 的 代码 便 不 能 执行 了 ， 这 时 tearDown 能 显示 出 非常 大 的 优势 ， 即 
不 管用 例 执 行 中 断 与 否 ， 最 后 都 会 执行 tearDown， 类 似 于 finnally 的 用 
法 ， 所 以 非常 适用 于 结 采 收集 、 次 源 释 放 及 环境 恢复 的 操作 。 


全 注意 。setUp、tearDown 会 于 同一 个 类 中 所 有 用 例 前 后 均 执行 
一 次 ， 而 非 只 执行 一 次 ， 所 以 一 般 同 一 场景 的 case 可 以 归 为 同一 类 ， 
方便 测试 环境 设置 及 恢复 。 若 case 条 件 不 同 ， 则 可 以 使 用 getName 方 法 
加 以 区 分 ， 以 做 不 同 的 用 例 前 置 操 作 及 场景 恢复 。 


3. 非 而 合式 用 例 设计 


在 实际 的 测试 设计 过 程 中 ， 很 有 可 能 出 现 用 例 对 环境 依赖 的 冲 
突 ， 比 如 A 用 例 需 要 设置 系统 锁 屏 为 无 ，B 用 例 需 要 设置 系统 锁 屏 为 密 
码 解锁 ， 倘 大 初始 环境 下 锁 屏 设置 为 滑动 解锁 ， 则 可 以 通过 以 下 两 种 
方案 设计 实现 。 


第 一 种 方案 征 全 面 考虑 所 有 可 能 并 在 setUp 中 解决 ， 只 关注 环 境 初 
台 化 ， 不 考虑 场景 恢复 。 在 此 方案 中 ， 用 例 的 设计 便 与 用 例 的 执行 顺 
序 产生 了 关联 ， 依 据 不 同 的 顺序 ，A 与 B 在 setUp 中 所 需要 做 的 初始 化 
工作 便 有 了 不 同 。 


.AB A， 设置 尔 屏 为 无 ,B， 设 置 为 密码 解锁 。 


.BA: B， 设 置 为 密码 解锁 ，A， 解 锁 密 码 ， 再 设置 锁 屏 为 元 。 


出 于 以 上 考虑 ，A 在 用 例 设 计时 惑 不 得 不 把 两 种 执行 顺序 都 考虑 
到 了 ， 在 A 初 始 化 时 检测 当前 是 否 有 密码 ， 知 有 ， 解 除 后 再 设置 为 无 
锁 屏 ， 这 对 于 A 来 讲 非 常 痛 百 ， 因 为 A 无 法 得 知 B 设 置 的 密码 是 什么 。 
B 也 需要 做 好 兼容 ， 因 为 它 不 知道 在 此 之 前 锁 屏 是 被 设置 为 无 锁 屏 ， 
还 十 补 设置 成 滑动 解锁 。 况 且 ， 在 以 后 的 测试 中 ， 考 虑 到 随 着 新 用 例 
的 增加 ， 可 能 会 对 环境 做 出 这 样 或 者 那样 的 修改 ， 每 次 用 例 新 增 后 都 
需要 对 此 前 的 用 例 再 进行 一 次 过 历 ， 看 是 否 需要 修改 初始 化 环境 ， 维 
护 的 代价 也 会 越 来 越 大 。 


第 二 种 方案 是 我 们 比较 推 尝 的 ， 所 有 测试 用 例 以 初始 环境 为 基 
准 ， 在 setUp 中 完成 初始 化 ， 并 在 tearDown 中 恢复 初始 环境 。 比 如 上 文 
中 的 例子 ， 则 A、B 被 设计 为 : 


.A: setUp 中 设置 为 无 锁 屏 ，tearDown 中 恢复 为 滑动 锁 屏 。 
:B: setUp 中 设置 锁 屏 为 密码 解锁 ，tearDown 中 恢复 为 滑动 锁 屏 。 


这 样 一 来 ， 思 路 就 清晰 了 很 多 ，A、B 都 只 需要 考虑 自己 所 做 的 更 
改 ，A 不 需要 知道 B 设 置 的 密码 ，B 也 不 用 管 在 此 之 前 是 无 锁 屏 还 是 滑 
动 锁 斌 ， 所 有 的 前 置 条 件 都 征明 确 的 ， 谁 污染 谁 治理 ， 谁 改 的 谁 负责 
改 回 去 。 按 照 这 个 规则 ， 即 便 后 续 添 加 再 多 痢 用 例 ， 都 不 会 对 已 存在 
的 用 例 造成 影响 ， 代 码 的 维护 代价 便 可 大 幅度 降低 。 


综 上 所 述 ， 在 UIAutomator 的 用 例 设 计 过 程 中 ， 建 议 所 有 测试 用 例 
之 间 都 做 到 完全 人 解 类 ， 每 一 个 用 例 都 可 以 单独 执行 ， 需 要 按照 一 定 顺 
序 执行 的 、 无 法 拆 分 的 场景 ， 建 议 都 写成 一 个 测试 用 例 。 


5.3.3 ”UIAutomator 实 中 案例 


行文 至 此 ， 读 者 对 于 UIAutomator 的 了 解 也 就 比较 全 面 了 ， 对 于 后 
续 上 自动 化 过 程 中 的 应 用 及 拓展 的 理解 ， 相 信也 都 不 在 话 下 。 余 下 的 ， 
就 是 需要 一 些 时 间 ， 在 实际 的 应 用 过 程 中 熟悉 对 它 的 应 用 ， 并 掌握 属 
于 目 己 的 风格 及 技巧 ,更 好 地 去 发 挥 它 的 作用 。 


在 自动 化 测试 的 领域 里 ， 其 目的 往往 在 于 解放 测试 人 力 ， 抑 或 形 
成 监控 对 异常 进行 警告 。 笔 者 作为 TOS (Tencent OS) 的 一 名 测试 人 
员 ， 也 是 在 实际 的 测试 过 程 中 ， 结 识 并 慢 慢 深入 了 解 UIAutomator 的 方 
方面 面 的 。TOS 作 为 2015 年 年 初 新 出 现 的 Android ROM， 经 验 尚 浅 ， 需 
要 进行 的 测试 任务 非常 繁杂 。 在 一 个 ROM 的 层面 上 ，UIAutomator 对 于 
一 些 问题 痛 点 能 带 来 怎样 的 解决 方案 ， 从 而 产生 更 多 的 收益 呢 ? 在 接 
下 来 的 内 容 里 ， 不 妨 来 了 解 一 下 UIAutomator 在 TOS 的 日 常 测试 过 程 中 
的 应 用 。 


2015 年 3 月 3 日 ，TOS 终 于 与 用 户 见 面 了 ， 开 启 了 内 测 的 征程 。 由 于 
TOS 用 心 的 设计 及 不 错 的 评测 ， 论 坛 上 开始 有 未 适 配 机 型 用 户 的 声音 ， 
渴望 能 体验 TOS。 为 了 让 “小 饼 ”(TOS Logo 形 象 ， 后 文 借 指 TOS) 早日 
与 更 多 的 用 户 见 面 ， 新 机 型 适 配 计划 随 之 也 被 提 上 议程 。 但 作为 新 起 
项 目 ， 人 力 及 测试 建设 都 存在 很 多 不 足 ， 在 没有 人 力 新 增 的 情况 下 适 


配 更 多 的 机 型 ， 工 作 量 直接 翻 鼻 ， 怎 么 能 挤 出 更 多 的 时 间 来 完成 新 机 
型 的 适 配 呢 ? 


那 时 候 大 体 的 测试 都 还 依靠 手工 进行 ， 在 TOS 中 大 部 分 系统 App 都 
是 经 过 深层 定制 的 ， 为 了 保证 发 布 的 质量 ， 测 试 流程 不 可 删 减 ， 于 是 
问题 便 从 这 块 硬骨头 可 不 可 以 不 哺 ， 转 换 为 可 不 可 以 不 由 测试 人 员 来 
肯 了 。 在 了 解 了 当前 主流 的 自动 化 测试 框架 后 ， 经 过 对 比 ， 最 终 挑选 
了 UIAutomator 作 为 自动 化 技术 选 型 ，TOS 作 为 Android OS， 测 试 关注 
不 同 于 App， 需 要 对 多 应 用 进行 跨 进程 的 场景 测试 ， 在 这 一 点 上 
UIAutomator 的 优势 非常 明显 。 


1.TOS 单 元 测试 


磨 好 了 刀 ， 接 下 来 瑟 要 看 往 哪 里 砍 了 。 在 TOS 流 程 中 ， 每 次 上 线 前 
都 需要 对 适 配 机 型 进行 基础 用 例 的 覆盖 测试 ， 以 确保 发 版 质量 ， 花 费 
人 力 在 8 人 /天 以 上 ， 而 且 这 部 分 的 测试 用 例 较 为 核心 ， 功 能 基础 ， 一 般 
路 径 痢 不 会 很 深 。 如果 可 以 做 目 动 化 支持 ， 晚上 下 班 回 家 前 让 目 动 
化 “ 跑 ” 起 来 ， 第 二 天 早上 上 班 时 束 能 看 到 测试 结案 了， 证 约 的 不 仅仅 
是 人 力 ， 更 缩 城 了 发 布 的 流程 。 


想 想 都 有 点 儿 小 激动 ， 于 十 便 开 始 筛选 用 例 ， 设 计 用 例 ， 编 码 实 
现 ( 偏 业 务 功能 走 查 ， 部 分 UI 检查 需要 涉及 截图 对 比 ， 。 按 梳理 完 的 
结果 ,很 快 ， 用 例 也 写 得 差不多 了 ， 在 目 己 的 PC 上 ， 束 可 以 看 到 目 动 


化 执行 日 志 及 绪 有 末了 ， 心 里 甚 是 欢喜 ， 那 时 候 的 测试 结 末 如 下 面 的 代 
码 所 示 。 


INSTRUMENTATION_STATUS: current=71 

INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner 
INSTRUMENTATION_STATUS: class=com.tencent,.cases.SystemSettingTestCase 
INSTRUMENTATION_STATUS: stream=. 

INSTRUMENTATION_STATUS: numtests=71 

INSTRUMENTATION_STATUS: test=testwifiGetDetail 
INSTRUMENTATION_STATUS_CODE: 0 

INSTRUMENTATION_STATUS: stream= 

Test results for WatcherResultPprinter=,. .os 


很 快 ， 问 题 也 接 号 而 来 。 随 着 实现 用 例 数 量 的 增多 ， 每 次 的 测试 
结 采 日 志 变 得 越 来 越 长 ， 每 次 看 执行 结果， 对 应 错误 用 例 并 定位 原因 
都 需要 花费 大 量 时 间 。 况 且 ， 总 不 能 把 这 样 的 执行 结 采 填写 在 测试 结 
果 邮 件 里 ， 笔 者 觉得 还 需要 更 好 看 的 结果 分 析 样 式 。 


了 解 到 UIAutomator 是 基于 Junit 进 行 编写 的 ， 笔 者 在 笑 试 进行 结果 
格式 化 之 前 便 先 到 网 上 了 解 是 否 有 较 好 的 解决 方案 ， 后 来 也 证 实 了 这 
个 寻找 并 没有 日 费 ，github 上 有 一 个 项 目 automator-log-coverter 


(https://github.com/dpreussler/automator-log-converter ) 其 所 做 的 工作 


天 是 将 UIAutomator 的 日 志 转 换 为 Junit 日 志 ， 借 助 uiautomator2junit.jar， 
就 可 以 轻松 地 从 执行 结果 里 得 到 一 份 标准 的 Junit 报 告 了 ， 有 了 这 份 
Junit 报 告 ， 对 于 结果 的 处 理 显 然 束 容易 了 很 多 。 


用 例 有 了 ， 报 告 有 有 了， 距离 自动 执行 并 发 送 结果 报告 的 愿景 已 经 
不 远 了 。 有 人 说 行为 上 的 懒惰 是 推动 人 类 不 断 向 前 发 展 的 源 果 ， 对 
此 ， 笔 者 不 置 是 非 ， 笔 者 只 知道 自己 很 懒 ， 懒 到 甚至 连 花 2.85 卡 路 里 点 
击 电 标 运行 一 个 脚本 也 不 想 干 ， 而 是 想 让 UIAutomator 目 己 执行 发 送 结 
果 ， 笔 者 只 要 坐 在 家 里 安静 地 看 看 邮件 就 好 ， 为 了 实现 这 件 事 ， 笔 者 
找到 了 Jenkins 。 


Jenkins 集 群 在 这 里 融 不 多 介绍 了 ， 大 多 数 的 目 动 化 持续 集成 都 会 
用 到 它 ，Jenkins 文 持 按 设 定 的 策略 目 动 执行 测试 Job， 文 持 结果 邮件 发 
送 ， 更 文 持 插件 扩展 ， 其 中 对 于 Junit 的 日 志 处 理 有 很 多 ， 这 对 笔者 来 
说 实在 是 再 赞 不 过 了 。 


关于 Junit 的 结果 处 理 ， 笔 者 选择 了 Junit Plugin， 可 以 根据 历史 执行 
结果 呈现 自动 化 的 结果 趋势 。 为 此 ， 需 要 在 Jenkins 上 每 次 将 Junit 结 果 
进行 归档 〈 几 百 KB 的 xml， 占 用 空间 很 小 ，， 添 加 完 Junit Plugin 以 后 ， 
报告 是 这 样 的 ， 浅 色 代表 总 的 用 例 执 行 数 ， 深 色 代 表 本 次 执行 失败 的 
用 例 数 ， 可 以 清晰 地 看 到 历史 执行 趋势 ， 如 图 5-9 所 示 。 


点 击 图 表 可 以 浏览 执行 结果 详情 页 面 ， 成 功 占 比 、 失 败 的 具体 用 
例 、 失 败 日 志 及 历史 执行 情况 ， 都 一 目 了 然 ， 如 图 5-10 所 示 。 使 用 
Jenkins 的 Jelly 邮 件 模板 把 图 表 及 链接 附 上 ， 后 面 的 工作 束 生 维护 用 例 
的 稳定 性 及 Job 的 执行 策略 了 。 


S40706 您 成 
N7100 0707 
S4 0713 您 成 … 
S4 0727 你 成 


图 5-9 应 用 Junit Plugin 后 UIAutomator 执 行 结果 的 展示 


Test Result 


5 次 失败 


所 有 失败 的 测试 


测试 的 名 称 


中 comtencentuiautomatorcases Systemsetting.SystemSettingTestCase testBlueCloseCanbeFound > 

路 comtencentuiautomatorcases.Systemsetting.SystemSettingqTestCase testSoundSetAlarm 

吃 com.tencent.uviautomator.cases.systemsetting.SystemSettingTestCase testAdvancedSettingStorageProcess 
哗 com.tencentuiautomatorcases.Systemsetting.SystemsSettingTestCasetestMobilenetOpen 

啤 comtencentuiautomatorcases Systemsetting.SystemSettingTestCase testMobilenetRoamOpen 


所 有 的 测试 


Package 花 的 时 间 失败 (区别 ) 跳 过 {区 别 ) Pass (区 别 ) 总 数 (区 别 ) 
com.tencent.uiautomatorcases.qwWeather 0 毫秒 0 13 +13 13 +13 
com.tencent.uiautomator.cases.systemsetting 0 毫秒 5 34 +34 39 +39 


com.tencent.uiautomator.cases.systemui 0 这 秒 19 +19 19 +19 


图 5-10 ”Junit Plugin 对 某 次 执行 结 末 的 详情 展示 


2.TOS 性 能 测试 


解决 了 TOS 的 单元 用 例 测 试问 题 ， 想 想 后 面 的 测试 就 可 以 听 点 儿 音 
乐 、 喝 杯 咖啡 ， 静 静 等 竺 报告 邮件 发 送 了 。UIAutomator 这 么 好 用 的 东 
西 ， 怎 么 可 以 只 停留 在 单元 用 例 测 试 这 里 呢 ? 


TOS 虽 然 年 轻 ， 但 有 着 一 颗 追 求 极致 、 不 断 挑战 自我 的 心 。 为 了 整 
机 更 好 的 性 能 (App 在 指定 场景 下 耗费 系统 资源 的 占 比 ， 如 内 存 、 
CPU、FPS 等 ) ， 我 们 需要 和 资深 MIUI 等 学 习 ， 通 过 性 能 测试 对 比 来 
找到 自己 的 “瓶颈 >， 寻 找 存在 优化 的 空间 。 另 外 ， 我 们 也 希望 每 周 能 
有 纵向 对 比 ， 监 控 更 新 内 容 是 否 会 对 性 能 产生 有 影响。TOS 测 试 团队 对 齐 
了 所 有 App 的 性 能 对 比 项 ， 并 将 其 固化 下 来 作为 ROM 的 核心 能 力 ， 定 
期 进行 性 能 测试 及 竞 品 对 比 测试 ， 以 此 来 不 断 提 升 自己 ， 同 时 形成 监 
控 ， 对 性 能 影响 较 大 的 修改 形成 预警 。 


但 性 能 的 测试 非常 耗费 时 间 ， 比 如 整体 的 灭 屏 待机 率 需 要 待机 休 
眠 24 小 时 ， 内 存 及 流畅 度 的 一 个 场景 测试 ， 可 能 需要 测试 人 员 不 停 地 
请 动 操作 半 个 小 时 ， 而 且 期 间 存 在 着 测试 人 员 不 同 使 结果 产生 差异 的 
因素 ， 比 如 滑动 的 快慢 、 前 置 条 件 存在 差异 等 ， 所 以 经 党 需要 多 次 测 
试 以 确定 稳定 值 ， 仅 TOS 的 性 能 测试 往往 就 需要 耗费 15 人 /天 。 


在 这 里 ，UIAutomator 强 天 的 两 个 特性 束 得 到 体现 了 ， 一 是 测试 不 
需要 代码 ， 对 于 苋 品 的 测试 拿 过 来 一 样 可 以 跑 起 来 ， 二 是 跨 进程 有 强 
大 的 兼容 性 ， 性 能 的 数据 采集 可 以 轻松 接 入 第 三 方 App 进 行 ， 且 不 需要 
专门 适 配 。 


针对 性 能 测试 需求 ， 笔 者 尝试 接 入 了 腾讯 性 能 随身 调 工 具 GT (由 
腾讯 研发 用 于 移动 并 对 App 进 行 性 能 监控 及 调试 的 应 用 ， 详 情 可 参见 
http://gt.qq.com ) ， 可 以 方便 地 采集 目标 App 的 内 存 、CPU、 流 畅 度 等 
方面 的 数据 。 接 入 的 方式 很 向 单 ， 应 用 UIAutomator 的 路 进程 操作 能 
力 ， 直 接 对 GT 进行 弄 面 操作 即 可 ， 也 可 以 将 GT 工具 的 操作 流程 封 交 成 
静态 工具 类 ， 在 需要 的 时 候 直 接 调用 会 更 加 方便 。 


关于 静态 工具 的 封装 ， 工 具 类 可 以 直接 继承 于 
UiAutomatorTestCase， 方 法 声明 为 静态 public 即 可 使 用 UIAutomator 的 目 
动 化 操作 交互 。 唯 一 的 区 别 在 于 ， 在 普通 的 测试 用 例 里 ， 可 以 调用 
getUiDevice () 获取 UiDevice 实 例 ， 但 静态 方法 中 无 法 调用 
getUiDevice () ， 所 以 需要 使 用 UiDevice.getInstance () 来 替代 。 


@ 提示 。 UiDevice 实 例 是 在 UIAutomator 执 行 准备 时 注入 的 ， 使 
用 UiDevice.getInstance () 或 者 在 继承 UiAutomatorTestCase 实 例 中 使 用 
getUiDevice 获 取 的 是 同一 个 实例 ， 一 个 是 类 静态 方法 ， 另 一 个 是 实例 
方法 ， 可 以 根据 使 用 场景 选择 合适 的 方法 进行 调用 。 


人 至此， 使 用 UIAutomator 操 作 性 能 测试 场景 ， 使 用 GT 记录 性 能 性 
据 ， 两 着 都 实现 了 。 但 存在 一 个 问题 ， 调 用 GT 记录 性 能 数据 的 操作 过 
程 以 及 性 能 测试 场景 的 前 期 准备 期 间 ， 性 能 已 经 开始 记 隶 了， 在 这 段 
时 间 内 采集 的 数据 不 能 作为 性 能 计算 范围 ， 需 要 予以 剔除 ， 但 作为 
GT， 它 无 法 知道 性 能 测试 场景 开始 的 精确 时 间 ， 那 怎么 办 呢 ? 


解决 方案 很 简单 。 在 目 动 化 过 程 中 ， 当 性 能 场景 开始 复 现 和 结 
时 ， 通 过 LOG 输 出 两 个 时 间 点 ， 通 过 IautomationSupport 记 录 到 结果 日 
志 中 ， 结 束 后 通过 取得 用 例 的 时 间 点 ， 到 GT 保存 数据 中 根据 时 间 岭 进 
行 数据 截取 ， 束 可 以 得 到 精确 的 测试 数据 了 。 


再 做 一 个 简单 的 历史 对 比 脚本 ， 同 样 集 成 到 Jenkins 上 ， 又 可 以 目 
动 下 发 执行 ， 继 续 喝 咖啡 等 邮件 了 ， 得 到 的 邮件 预 虎 如 图 5-11 所 示 ， 
UIAutomator 叉 可 以 继续 为 “小 钰 ”扬帆 保驾 护航 了 。 


测试 场 呈 。 上 一 版 本 PSS (MB) ”当前 版 本 PSS (MB) ”同比 增 硕 ”上 一 版 本 CPU (%) ”当前 版 本 CPU (%) ”同比 增 沽 ”上 一 版 本 SM ”当前 版 本 SM ”同比 增 减 
锁 屏 静 置 场 晴 TOS 35.29 | 35.47 37.38 | 37.59 15.93% 6.43 | 36.36 3.98 | 29.11 1-38.15% 94.00 95.00 11.06% 
锁 屏 滑动 场 式 TOS 35.73 | 35.95 39.07 | 39.33 19.35% 22.23126.63 23.64 | 28.37 16.34% 11.02% 
虑 面 前台 静 置 场景 TOS 45.88 | 49.37 45.68 | 49.57 10.44% 104313088 3.88 | 19.42 162.80% 
车 面 后 台 节 于 场 吴 TOS .38| 51.75 40.99 | 41.83 1-15.26% 0.8314.13 0.03 | 1.42 1-96.73% 
宗 面 守 面 滑动 场景 TOS .15 | 49.28 46.411 50.24 10.56% 14,64 123.21 16.67 | 26.78 113.87% . . 0.0036 
卓 面 文件 来 操作 场 TOS .48170.74 48.44 1 55.66 上 5.90% 10.53124.11 10.22 | 28.86 上 3.00% ， , 1-1.20% 
点 面 前 台 静 首 场 系 _ GO 点 面 .93 | 67.26 69.39 | 69.53 13.67% 0551872 49 | 8. 1-1190% 
桌面 后 台 静 主场 曲 GO 点 面 .22 | 66.52 68.43 | 68.63 13.33% 0.29 |1.94 .20 | 1. 1-32.48% 
提 耐 卓 面 油 动 场 惊 .GO 点 而 ,36 | 78,36 56.74172.27 12.49% 23.42 128.62 114.31% 
卓 面 .前 台 襄 置 场景 _360 点 面 .06 | 36.10 35.99 | 36.51 12.65% 0.56 | 23.52 05 | 5 1-90.94% 
桌面 后 台 表 下场 呆 _360 球面 .80 | 32.81 35.97 | 36.03 19.66% 0.0212.38 .01 | 2. 1-3234% 
案 面 _ 宗 面 洞 功 场 号 _]60 宗 面 .38 | 36.50 37.07 | 39.25 15.97% 3.05 | 19.70 .96 | 15, 110.13% 
盯 面 文件 夹 控 作 场 暴 360 宗 面 711 61.84 71.30172.00 117.45% 9.38 | 25.22 5 4-7.01% 
SystemUI 宗 面 静 辐 场 且 TOS .59 | 23.95 24.05 | 24.58 11.91% 16619.16 .18 | 4 1-88.98% 
SystemUl 通知 栏 静 富 场 兵 TOS .75 | 24.35 22.95 | 24.30 4-3.39% 2.01 | 13.85 ). . 1-77.82% 
SystemU[_ 快 三 开关 前 吾 场 县 _ TOS 3.68 | 23.94 23.04123.47 上 272% 2.34115.97 。 1-82.09% 
Systpml 1 运 知 栏 澡 动 场 屋 _TOS 2443 2343123 F7 7 439%, 104611762 tn42% 
RecentUT 任务 栏 涓 动 场 屋 TOS ,20 | 30, 29.42 | 30.84 18.14% 7.03 | 11.76 | : 128.30% 


RecentUL 住 务 训 措施 吾 场 用 _10S 20 | 30, 21.61 | 29,06 11.51% 0.0/ | 12.06 .27 | 7/ 1285.11% 


系统 设置 打开 欧 至 场 刁 TOS 31.39| 32.20 117.29% 3.4419.39 . |. 4-0.80% 


图 5-11 TOS 性 能 目 动 化 测试 结果 邮件 


3.TOS 压 力 测试 


作为 一 名 测 斌 人员， 也 许 会 有 这 样 的 经 历 : 在 测试 过 程 中 遭遇 非 
必 现 问题 、 对 用 户 反 馈 问 题 无 法 复 现 、 部 分 压力 测 弃 场 景 过 于 耗 时 

。 很 多 时 候 ， 由 于 问题 的 偶然 性 ， 在 开发 人 员 定 位 问题 的 过 程 中 无 
法 提供 有 效 信息 ， 导 致 问题 被 长 期 搁置 ， 往 往 也 会 在 尝试 复 现 的 过 程 
中 耗费 大 量 的 人 力 。 


在 TOS 内 测 发 布 后 ， 有 部 分 用 户 反 馈 手 机 容易 出 现 卡 顿 、 操 作 无 响 
应 等 现象 。 在 用 户 的 协助 下 ， 我 们 从 dropbox 中 获取 了 部 分 日 志 ， 定 位 
到 手机 端 时 出 现 了 low memory 的 现象 ， 即 系统 可 用 内 存 极 低 造 成 卡 


EE 


页， 只 可 惜 日 志 不 够 详细 ， 无 法 定位 到 具体 原因 。 在 此 之 后 ， 测 试 人 
员 努 力 尝 试 了 两 天 多 ， 但 仍 示 能 成 功 复 现 问题 。 


为 了 尽快 解决 定位 问题 ， 我 们 想 通 过 目 动 化 加 大 测试 强度 来 尝试 
复 现 问 题 ， 既 然 是 lowmem 场 景 ， 那 么 就 在 手机 闻 安 装 大 量 的 第 三 方 
App， 通 过 第 三 方 App 的 唤醒 来 消耗 系统 内 存 使 系统 达到 资源 紧张 的 状 
仿 ， 具 体 实现 的 过 程 如 下 : 


(1) 在 手机 端 安装 大 量 第 三 方 App。 
(2) 使 用 pm list packages-3 获 得 第 三 方 App 列 表 包 名 。 
(3) 通过 包 名 列表 不 断 循 环 调 起 App， 并 退 至 后 台 不 杀 死 。 


(4) 过 程 中 使 用 dumpsys meminfo 对 内 存 采 样 ，logcat 抓 取 系 统 


et 
O 


(5) 监控 dropbox 目 录 是 否 存 在 lowmem 日 志 ， 一 旦 出 现 即 为 问题 
复 现 。 


以 上 过 程 可 以 作为 一 条 UIAutomator 的 测试 用 例 ， 通 过 编码 在 用 例 
中 调用 Runtime 来 执行 指令 ， 完 成 App 操 作 及 信息 监控 。 通 过 夜间 的 目 
动 化 压 测 ， 在 重复 至 2000 多 次 的 App 操 作 时 ， 我 们 稳定 地 复 现 了 该 问题 
场景 ， 为 开发 提供 了 有 效 的 问题 现场 以 定位 。 


在 此 之 后 ， 我 们 很 重视 App 的 压力 测 斌 环节， 产品 上 线 前 ， 都 需要 
跑 一 壳 压 测 ， 其 中 最 为 普通 的 方法 ， 便 是 使 用 Monkey 进 行 。 遗憾 的 
是，Monkey 走 完全 随机 的 上 讨 力 测试 过 程 ， 没 有 任何 的 业务 逻辑 存在 于 
其 中 ， 对 于 部 分 需要 登录 或 是 顺序 操作 的 场景 ， 便 无 法 覆盖 了 ， 而 且 
对 于 部 分 不 存在 Activity 的 App (如 锁 屏 、 系 统 界 面 等 ) 会 如 现 如 下 代 
码 所 示 的 错误 。 


255|root@cancro:/ # monkey -p com.android.keyguard -v 10000 
monkey -p com.android,.keyguard -v 10000 

:Monkey: seed=1451195107020 count=10000 

:AllowPackage: com.android.keyguard 

:IncludeCategory: android,.intent.category .LAUNCHER 
:IncludeCategory: android,.intent.category.MONKEY 

** No activities found to run, monkey aborted. 


怎么 解决 这 个 问题 呢 ? 作为 Monkey， 其 主要 的 事件 分 类 有 点 击 事 
件 、 按 钮 事件 、 滑 动 事件 等 ， 而 这 些 在 UIAutomator 中 都 可 以 很 方便 地 
实现 。 以 UiDevice 为 入 口 ， 可 以 使 用 dick、swipe 等 方法 来 产生 屏幕 交 
互 事 件 ， 使 用 pressKeyCode 来 产生 按钮 事件 ， 只 要 模拟 Monkey 把 事件 
进行 归 类 ， 分 配 好 事件 发 生 的 概率 ， 就 可 以 得 到 定制 版 本 的 压力 自动 
化 脚本 了 。 相 较 于 Monkey，UIAutomator 压 力 自动 化 脚本 有 着 不 少 优 


势 : 


-使 用 灵活 ， 可 以 巧妙 加 入 业务 逻辑 ， 如 登录 、 顺 序 跳 转 等 。 


可 以 加 入 性 能 监控 、 日 志 监 控 ， 自 定义 所 需 信息 。 


:测试 不 依赖 Activity， 光 围 注 盖 界面 及 指令 级 别 测试 。 


可 限定 界面 测试 ， 相 较 于 Monkey 指 定 包 名 范围 可 以 更 小 。 


-可 以 跨 进 程 测试 ， 不 局 限于 同一 包 名 ， 较 于 Monkey 范 围 又 可 以 更 
大 。 


借助 于 UIAutomator 的 强大 功能 ， 在 压力 测试 这 一 环 玉 ， 我 们 少 
了 很 多 杰 路 。 最 初 TOS 开 始 适 配 久 能 手表 的 时 候 ， 由 于 硬件 性 能 限制 及 
App 规 范 不 同等 因素 ， 一 些 本 来 很 小 的 问题 被 放大 了 ， 系 统 及 App 经 第 
会 出 现 不 稳定 现象 ， 比 如 Crash、ANR、 内 存 汇 漏 ， 都 会 产生 较 大 的 影 
啊 。 在 这 种 情况 下 ， 对 App 的 要 求 承 更 为 户 格 ， 压 测 也 就 更 为 重要 。 


很 可 惜 ， 在 这 种 情况 下 大 部 分 的 测试 App 由 于 未 对 手表 进行 适 配 ， 
都 无 法 使 用 ， 于 是 我 们 借助 UIAutomator 模 拟 Monkey 对 手表 上 的 App 进 
行 了 系列 测试 ， 并 封装 了 部 分 关键 性 能 采集 工具 (PssMonitor、 
CpuMonitor、FpsMonitor) ， 全 程 监控 App 的 性 能 表现 。 前 期 很 快 地 暴 
露 了 App 的 性 能 及 稳定 性 问题 ， 快 速 完成 了 稳定 收敛 的 过 程 ， 为 之 后 的 
测试 开发 争取 到 更 多 时 间 ， 并 将 此 作为 此 后 的 常规 监控 项 ， 加 入 持续 
集成 平台 中 。 


4. 遇 到 的 问题 与 解决 


1) 乱码 及 输入 问题 


在 开发 过 程 中 常会 遇 到 字符 编码 的 问题 ， 而 且 是 一 个 比较 让 人 头 
疼 的 问题 ， 平 时 编码 过 程 采用 UTF-8 简 直 是 编程 界 的 “传统 美德 ”。 在 
UIAutomator 编 码 的 过 程 中 ， 也 有 几 个 地 方 会 涉及 中 文 编码 ;text 文案 
匹配 (如 UiSelector.text、UiScrollable.getChildByText) 、 控 制 台 LOG 输 
出 信息 、 控 件 文案 输入 (如 UiObject.setText) 


对 于 text 文 案 匹 配 ， 解 决 的 方法 很 简单 ， 把 当前 项 目 编码 调整 成 
UTF-8 即 可 。 有 些 IDE 默 认 随 系统 设置 工作 空间 编码 为 GBK、GB2312 
等 ， 就 会 导致 定义 的 字符 串 以 中 文 编码 的 方式 进行 。 在 UIAutomator 控 
件 匹 配 过 程 中 ， 被 翻译 成 UTF-8 后 就 会 失去 原来 的 意思 ， 导 致 控件 无 法 
匹配 ， 这 也 是 有 些 用 户 会 认为 UIAutomator 不 支持 中 文 的 原因 。 


控制 台 LOG 输 出 信息 由 System.out 来 完成 ， 我 们 可 以 将 其 再 次 封装 
并 指定 编码 格式 来 解决 中 文 乱码 问题 ， 对 应 的 调用 从 System.out 切 换 到 
mpPrintStream， 代 码 如 下 : 


PrintStream mpPrintStream = new PrintStream(System.out, true, "GB2312"); 
mprintStream.println(...); 


最 后 中 文 输入 的 问题 表现 为 依赖 于 当前 输入 法 ， 比 如 调用 语句 
setText (“tong”) 进行 输入 的 时 候 ， 当 前 如 果 是 拼音 输入 法 ， 可 能 会 得 
到 “ 同 ” 如 末 是 五笔 输入 法 ， 可 能 会 得 到 “释怀 ”， 结 来 变 得 不 可 预料 。 


我 们 可 以 通过 引入 Utf7Ime 来 解决 这 个 不 稳定 问题 ， 因 为 
UiObject.setText (String) 只 能 接受 ASCII 码 ， 在 我 们 输入 的 过 程 中 ， 先 
用 Utf7Ime 将 编码 的 字符 串 编码 成 ASCH 码 ，setText 接 受 这 些 ASCl! 码 后 
再 通过 Utft7Ime 这 个 输入 法 解码 成 我 们 此 前 编码 的 字符 串 输 出 ， 以 此 来 
保持 输入 内 容 的 一 致 性 。 具 体 方法 如 下 : 


(1) 打包 下 载 ， 下 载 地 址 为 https://github.com/sumio/uiautomator- 


unicode-input-helper 。 
(2) 导入 其 中 的 Utf7Ime， 生 成 apk 并 安装 设置 成 默认 输入 法 。 


(3) 把 Utf7ImeHelper.java 导 入 自己 的 公用 方法 库 ， 用 于 把 字符 串 
encode 成 ASCII 码 。 


(4) 在 自动 化 过 程 中 ， 可 以 使 用 如 下 面 代码 所 示 的 方法 来 查询 及 
设置 系统 默认 输入 法 。 


> Android 4.2 以 前 : 


dumpsys input_method | grep mCurMethodId 
ime set jp.jun_nama.test.utf7ime/.Utf7ImeService 
> Android 4.2  ( 含 ) 以 后 : 


settings get secure default_ input_method 
settings put secure default_ input_ method jp.. 


utf7ime/ .Utf7ImeService 


2) 引用 第 三 方 包 编译 问题 


当 对 UIAutomator 使 用 越 来 越 熟 练 的 时 候 ， 笔 者 希望 能 把 结果 处 理 
也 放 到 目 动 化 中 来 。Java 的 扩展 库 非 常 丰富 ， 例 如 在 本 次 的 实战 过 程 中 
束 使 用 了 json 的 第 三 方 包 ， 但 在 编译 的 时 候 就 发 现 ant 会 报错 ， 原 因 是 
json 的 包 没 有 找到 。 


ant 是 根据 脚本 build.xml 进 行 构建 的 ， 其 内 容 主 要 部 分 引入 了 
uibuild.xml 来 完成 真正 的 构建 过 程 ， 这 个 文件 同样 也 在 /SDK/tools/ant/ 
目录 下 ， 内 容 如 代码 清单 5-13 所 示 。 


代码 清单 5-13 build.xml 中 引入 uibuild.xml 部 分 代码 


<!-- Import the actual build file. 
To customize existing targets, there are two options: 


- customize to your needs. 


--> 
<import file="${sdk.dir}/tools/ant/uibuild.xml" /> 


查看 uibuild.xml 的 内 容 ， 我 们 就 可 以 在 compile 和 -dex 的 过 程 中 加 入 
我 们 的 依赖 库 以 完成 编译 与 打包 ， 修 改 可 以 如 代码 清单 5-14 所 示 ， 添 加 
依赖 libs 编 译 脚本 ， 更 多 的 用 法 还 可 以 检索 ant build.xml 学 习 。 


代码 清单 5-14 添加 依赖 libs 编 译 脚本 


<target name="compile" depends="-build-setup, -pre-compile"> 
<javac encoding="${java.encoding}" 
source="${java.source}" target="${java.target}" 


verbose="${verbose}" 


fork="${need.javac.fork}"> 
<src path="${source.absolute.dir}" /> 
<compilerarg line="${java.compilerargs}" /> 
<classpath> 
<fileset dir="${jar.1libs.dir}" includes="*.jar"/> 
</classpath> 
</javac> 
</target> 
<target name="-post-compile"/> 
<target name="-dex" depends="compile, -post-compile"> 
<dex executable="${dx}" 
output="${intermediate.dex.file}" 
nolocals="@{nolocals}" 
verbose="${verbose}"> 
<fileset dir="${jar.1libs.dir}"> 
<include name="json.jar"/> 
</fileset> 
<path path="${0out.classes.absolute.dir}"/> 
</dex> 
</target> 


3) 长 时 间 执 行 adb 不 稳定 问题 


我 们 知道 ， 通 过 adb shell 执 行 UIAutomator 的 时 候 ， 如 果 想 中 断 测 
试 只 要 结束 shell 就 可 以 了 ， 非 常 方 便 ， 不 过 这 也 为 后 面 的 自动 化 带 来 
了 问题 。 随 着 测试 用 例 越 来 越 多 ， 加 之 有 的 压力 测试 场景 时 间 偏 长 
一 次 自动 化 测试 过 程 时 长 可 能 在 8 小 时 以 上 。 如 果 在 执行 的 过 程 中 USB 
断 开 ， 那 么 测试 便 会 中 断 ， 而 在 PC 上 ， 手 机 助手 或 者 管家 卫士 重启 或 
是 占用 adb 端 口 的 现象 时 而 存在 ， 就 算 不 被 重启 或 是 占用 ， 在 Windows 
上 长 时 间 的 adb 连 接 还 是 会 因为 供电 不 稳定 等 因素 而 发 生 断 开 ， 所 以 往 
往 几 个 小 时 的 测试 都 会 白费 。 


怎么 解决 这 个 问题 呢 ? 前 面 讲 到 UIAutomator 执 行 过 程 中 有 一 个 参 
数 一 一 -nohup， 我 们 可 以 在 执行 的 指令 后 面 加 上 该 参数 ， 把 
UIAutomator 挂 起 ， 在 设备 后 台 运 行 ， 这 样 设备 是 否 保持 adb 连 接 束 没有 


关系 了 。 至 于 对 UIAutomator 执 行 状态 的 获取 ， 我 们 可 以 写 脚 本 ， 通 过 
ps 查看 进程 是 否 仍 在 运行 ， 轮 询 至 进程 停止 即 为 执行 结束 ， 再 拉 取 执 
行 结果 。 


UIAutomator 脱 离 adb 执 行 后 扩展 性 更 强 ， 可 以 兼容 更 多 的 上 自动化 场 
景 ， 比 如 耗 电 自动 化 测试 〈 要 求 USB 在 非 连 接 状态 下 进行 ) ， 或 者 是 
通过 apk 调 用 UIAutomator 进 行 目 动 化 测试 ， 封 闻 和 用 功能 供用 户 使 用 ， 
或 者 古 测试 结 采 db 持久 化 ， 等 等 ， 束 都 可 以 信 手 挡 来 了 。 


5.4_ UIAutomator 总 结 


UIAutomator 目 动 化 框架 很 镜 单 ， 使 用 起 来 却 非常 灵活 ， 其 留 给 开 
发 者 目 己 拓展 的 目 由 空间 还 是 比较 多 的 。 对 于 存在 问题 的 地 方 ， 我 们 
大 可 以 对 源码 进行 跟踪 解读 ， 多 完 根 多 思考 ， 总 能 找到 满意 的 解决 办 
法 ， 在 Android 界 面目 动 化 过 程 中 ， 还 是 非常 推荐 使 用 UIAutomator 目 
动 化 框架 的 。 对 于 目 己 实践 过 程 中 的 一 些 体会 ， 也 可 稍 作 总 结 以 相互 


学 习 。 


5.4.1 ”UIAutomator 代 码 规范 及 建议 


在 目 动 化 编码 的 过 程 中 ， 和 常常 需要 反复 修改 ， 殊 是 用 例 兼 容 性 及 
稳定 性 的 增强 。 从 App 或 系统 层面 的 测试 ， 到 对 于 不 同 机 型 的 兼容 ， 
我 们 需要 考虑 不 同 的 分 辩 率 等 对 于 脚本 产生 的 有 影响。 虽然 UIAutomator 
是 基于 控件 进行 的 自动 化 操作 ， 但 进行 过 程 中 还 是 有 一 些 细 说 可 以 帮 
助 提升 脚本 的 兼容 性 及 稳定 性 的 。 


:遵循 UIAutomator 用 例 设计 模式 。 在 目 动 化 过 程 中 ， 使 用 Assert 叶 | 
言 加 入 预 设 逻辑 ， 灵 活 控 制 case 执 行 ， 善 用 setUp、tearDown 方 法 ， 执 
行 过 程 会 更 加 清晰 可 控 ， 也 便于 后 期 代码 维护 。 


-用例 解 而， 共同 维护 初始 测试 环境 。 用 例 之 前 避免 糊 合 关系， 防 
止息 序 执行 市 来 不 可 预期 的 影响 ， 共 同 维护 测试 环境 ， 确 你 每 个 用 例 
执行 前 初始 环境 的 一 致 性 ， 避 免 用 例 间 执行 的 影响 。 


少 用 绝对 坐标 ， 基 于 控件 或 相对 坐标 进行 。 绝 对 坐标 在 不 同 机 型 
适 配 时 兼容 性 入， 维护 成 本 高 ， 尽 可 能 使 用 控件 进行 交互 ， 可 以 使 用 
控件 的 边框 信息 Rect， 或 者 使 用 屏幕 的 宽 高 信息 按 比例 计算 相对 坐 
标 。 


少 用 sleep， 多 使 用 框架 事件 等 待 。sleep 方 法 休眠 时 间 固 定 ， 时 
间 长 了 影响 测试 速度 ， 时 间 短 了 失败 概率 又 会 上 升 。 建 议 使 用 
waitForExists 、waitUtilGone 、waitForIde、waitForWindowUpdate 等 方 
法 奉 代 ， 这 一 系列 方法 在 超时 时 间 内 一 旦 条 件 达成 就 会 继续 往 下 执 
行 ， 不 会 当 费 测试 时 间 ， 在 到 达 超 时 后 也 会 继续 向 下 执行 ， 比 sleep 更 
为 灵活 ， 可 以 完全 替代 sleep。 


- 城 少 API 依 赖 ， 多 思考 替代 方法 。 对 于 官方 的 API， 不 要 百 分 之 
百 的 依赖 ， 存 在 疑惑 的 时 候 深 究 其 根 因 ， 然 后 更 好 地 改造 、 使 用 它 。 
比如 longClick 的 长 按时 间 固 定 ， 但 用 户 可 以 使 用 相同 起 终点 的 swipe 来 
模拟 长 按 并 目 定 义 时 长 ， 比 如 4.4.2 版 本 中 的 scrollForward 方 法 可 能 会 
因 起 终点 无 法 触摸 而 失效 ， 而 swipe 系 列 方法 不 存在 该 限制 等 ， 多 思 
考 ， 办 法 总 会 有 的 。 


5.4.2 ”UIAutomator 技 巧 及 封装 


UIAutomator 虽 然 作 为 界面 自动 化 框架 ， 但 在 实际 自动 化 测试 应 用 
过 程 中 ， 还 有 不 少 内 容 可 以 挖掘 ， 突 破 界 面 的 限制 ， 我 们 可 以 看 到 更 
多 ， 用 得 更 加 顺手 。 


1. 巧 用 Runtime 


UIAutomator 有 个 先天 性 的 缺点 ， 束 是 执行 时 界面 匹配 问题 ， 每 一 
个 动作 都 需要 进行 界面 壳 历 ， 所 以 在 测试 的 过 程 中 操作 难 显 迅 速 ， 加 
之 UI 测试 各 界面 泻 染 及 跳 转 需 要 消耗 时 间 ， 加 长 了 用 例 执行 的 耗 时 。 
对 于 每 个 用 例 有 其 明确 的 检查 点 ， 在 去 往 检查 点 的 路 径 上 ， 如 果 操 作 
对 于 检查 点 没有 影响 ， 可 以 考虑 能 人 否 使 用 指令 代 奉 ， 以 万 省 时 间 。 


比如 在 TOS 上 想 打开 日 期 设置 ， 检 查 自 动 确定 时 区 是 否 启用 ， 通 过 
纯 UI 操 作 ， 需 要 经 历 以 下 几 步 : 进入 桌面 -进入 应 用 检索 -打开 系统 
设置 ~ 打开 高 级 设置 ~ 打开 日 期 和 时 间 设 置 ~ 检 查 时 区 开关 是 否 开 
启 ， 如 图 5-12 所 示 。 


《 


日 期 和 时 间 


滞 坪 
语言 


其 他 连接 方式 


国人 桌面 和 锁 屏 
@ 显示 
辆 上 声音 


及 通知 


图 5-12 确认 目 动 时 区 功能 是 否 打 开 UI 操作 过 程 


整个 过 程 需要 和 五 个 页 面 交 互 ， 其 中 还 包含 三 个 滑动 列表 ， 编 码 
实现 需要 至 少 八 个 类 、 几 十 行 代码 。 但 最 终 的 检查 点 只 存在 于 进入 日 
期 和 时 间 设 置 页 面 之 后 开关 的 状 在， 中间 怎么 进入 该 页 面 对 结 果 并 没 

影响 ， 所 以 我 们 可 以 这 样 改 一 下 : 


通过 Runtime 执 行 指令 打开 日 期 和 时 间 页 面 ~ 检 查 时 间 同 步 开 关 是 
否 开 启 。 而 前 一 步 只 需要 一 条 指令 : am start-a 
android.settings.DATE_SETTINGS， 避 开 了 繁杂 的 界面 交互 ， 且 不 存在 
不 同 机 型 的 兼容 性 问题 ， 用 例 执行 时 间 可 以 大 大 缩短 ， 同 时 兼容 性 、 
稳定 性 也 有 所 提高 ， 是 非常 巧妙 的 应 用 。 


Runtime 指 令 功能 丰富 ， 信 息 获 取 及 结果 处 理 非 常 灵活 ， 我 们 可 以 
借助 它 来 获取 系统 信息 、 设 置 测试 环境 、 封 装 性 能 监控 工具 等 ， 结 合 


ROOT， 操 作 系统 几乎 无 所 不 能 ， 也 是 目 动 化 过 程 中 的 一 大 利 硒 ， 非 利 
推荐 使 用 。 


2. 巧 用 settings 


settings 是 Android 4.2 之 后 引入 的 一 个 系统 工具 ， 其 具体 的 作用 是 
可 以 方便 地 获取 设置 设备 变量 ， 不 需要 ROOT 权限 ， 塌 比 一 个 比较 BUG 
的 存在 ， 许 多 手机 助手 或 者 管家 都 利用 它 来 获取 额外 的 权限 对 设备 进 
行 操作 ， 对 于 测试 人 员 来 讲 ， 也 有 非常 便利 的 地 方 。 


首先 来 看 看 它 的 具体 用 法 ， 可 参见 SettingsCmd.java 源 码 中 的 帮助 
信息 ，settings 指 令 的 基本 用 法 有 两 个 ， 一 是 获取 属性 值 (get) ， 二 是 
设置 属性 值 (set) ， 其 指令 帮助 信息 如 下 面 的 代码 所 示 : 


> settings 
usage: settings [--user NUM] get namespace key 
settings [--user NUM] put namespace key value 
'namespace' is one of {system, secure, global}, case-insensitive 
f '--user NUM' is not given, the operations are performed on the owner user. 


namespace 是 名 空间 {system，secure，global} 中 的 一 个 ， 至 于 具体 
的 Key， 可 以 参考 官方 API 文 档 获 取 其 舍 义 。 在 这 三 个 类 里 ， 都 存在 诸 
如 getFloat、getInt、getString 等 方法 。 对 于 开发 者 来 说 ， 可 能 早已 经 不 
陌生 了 ， 其 实 这 三 个 类 取 值 的 数据 来 源 都 是 一 样 的 ， 只 是 对 settings.db 
内 的 值 进行 读 取 和 修改 而 已 ， 不 同 的 名 空间 ， 只 是 对 于 Key 的 属性 不 同 
的 归 类 而 已 。 早 期 ， 大 多 数 的 值 都 是 归属 于 system 的 ，API Level 17 之 


后 ， 部 分 System 的 Key 被 废弃 ， 同 时 移 至 secure 或 global 中 ， 但 Key 的 值 
保持 不 变 ， 使 用 过 程 中 需要 注意 API Level， 如 部 分 参数 在 一 定 Level 后 
废弃 ， 如 图 5-13 所 示 。 


public static final String AIRPLANE_MODE_ON 


This constant was deprecated in APl level 17. 


Use AIRPLANE MO N instead 


Constant Value: "airplane_mode_on 


图 5-13 ” ”API 废弃 后 在 官网 添加 的 说 明 
对 于 settings 中 的 值 ， 大 体 有 以 下 几 种 ， 也 非常 容易 使 用 。 


enable or disable: 使 用 1、0 的 区 分 来 表示 enable、disable 。 


-mode: 使 用 int 值 来 表示 不 同 的 模式 ， 具 体 柑 式 可 以 在 常量 定义 中 
找到 


String: 使 用 String 来 记录 串 值 及 URI。 


作为 Android 的 应 用 ， 在 运行 时 需要 与 系统 各 种 状态 打交道 ， 像 Wi- 
Fi、 蓝 牙 、 定 位 等 。 在 和 这 些 模块 交互 的 过 程 中 需要 申请 相应 的 权限 ， 
Android 的 权限 分 类 很 多 ， 使 用 起 来 并 不 是 很 方便 。UIAutomator 测 试 的 
jar 包 不 能 取得 运行 时 的 上 下 文 ， 也 无 法 配置 相应 的 应 用 权限 ， 而 通过 


settings 类 ， 我 们 却 可 以 很 方便 地 获取 设备 状态 信息 及 设置 相应 的 属性 
以 供 测试 ， 如 下 面 的 代码 所 示 。 


settings get global auto_time // 是否 自动 同步 网 络 时 间 
settings get global wifi _on // WI-Fi 是 否 打开 
Settings get System next_alarm_formatted // 获取 下 一 次 闹钟 
settings put System Screen_brightness 150 // 设置 屏幕 亮度 


settings put System Screen_off_timeout 600000  ”// 设置 屏幕 休眠 时 间 


@@ 提示 。 2015 年 3 月 ，Google 把 此 前 分 散 的 测试 组 件 合成 了 一 个 
统一 的 Android Testing Support Library，UIAutomator 由 此 被 
Instrumentaion 收 入 订 下 ， 发 布 了 2.0 版 本 ， 这 意味 着 UIAutomator 也 具备 
了 Instruomentaion 的 特性 ， 可 以 获取 Android 应 用 上 下 文 ， 也 可 以 与 
Espresso 等 框架 结合 使 用 ， 功 能 变 得 更 加 强大 。 由 于 新 版 本 使 用 方法 及 
环境 相差 较 大 ， 在 这 里 不 展开 详 述 ， 感 兴趣 的 读者 可 以 自行 前 往 官网 
了 解 : http://developer.android.com/intl/zh-cn/tools/testing/testing- 


tools.html 。 


5.5 ”本草 小 结 


UIAutomator 作 为 一 个 基于 控件 不 需要 源码 的 目 动 化 测试 框架 ， 其 
跨 进 程 的 文 持 及 事件 等 竺 机 制定 极 具 优势 的 特性 ， 站 在 测试 的 角度 来 
讲 ， 不 管 是 什么 工具 ， 只 要 有 利于 提高 测 弃 效率 及 测试 质量 ， 束 是 好 
工具 ，UIAutomator 在 此 表现 出 了 强大 的 兼容 性 ， 可 以 方便 地 文 持 App 
类 及 指令 类 的 功能 拓展 。 其 框架 简单 ， 容 易 上 于， 但 功能 强大 ， 留 给 
开发 者 目 由 发 挥 的 空间 很 大 ， 能 满足 绝 大 部 分 的 测试 需求 。 作 为 一 名 
测试 工程 师 ， 只 要 多 竹 试 、 多 思考 ， 我 们 相信 和 解决 的 办 法 总 会 有 的 ! 


第 6 章 Appium 框 架 解 析 及 实践 


本 章 将 介绍 与 Appium 测 试 框架 相关 的 知识 。 如 图 6-1 所 示 ， 在 本 章 
第 一 部 分 介绍 了 Appium 框 架 的 原理 以 及 重要 的 技术 特点 ， 这 些 原 理 和 
特点 可 以 在 选择 测试 方案 时 帮助 测试 人 员 做 决定 。 第 二 部 分 内 容 介绍 
了 如 何 搭建 Appium 测 试 框架 的 环境 和 入 手写 一 个 基本 的 测试 脚本 ， 
部 分 知识 对 刚 接 触 Appium 框 架 的 新 手 有 一 定 的 指导 作用 。 第 三 部 分 是 
Appium 应 用 的 进 阶 知识 ， 该 部 分 内 容 介 绍 了 Appium 在 腾讯 地 图 这 个 项 
目 中 的 实践 过 程 ， 并 对 在 实施 测试 过 程 中 遇 到 的 一 些 问 题 和 解决 方案 
进行 了 阐述 。 


对 Appium 框架 原理 的 概要 介绍 
Appium 优 缺 点 的 说 明 


环境 搭建 一 测试 框架 的 搭建 步 又 
yy 外 测试 示例 一 通过 HelloWorld 脚本 示例 描述 如 何人 手 
正 江 人 | 


Desired Capabilities 的 说 明 一 Desired 和 中 各 字段 的 说 明 


省 直 API 的 解读 一 对 Appium 中 常用 方法 的 解 
ppium 


解析 及 实践 Appium 接口 的 封装 一 讲述 在 笔者 项 目 中 对 一 些 方法 的 二 次 封装 
测试 脚本 设计 思想 一 讲述 笔者 对 Appium 自动 化 测试 的 思考 方法 
项 目 实践 腾讯 地 图 的 测试 实践 一 讲述 笔者 项 目 中 自动 化 测试 实施 过 程 
Hybrid App 的 测试 方法 一 讲述 如 何 做 Hybrid App 的 测试 
Appium 脚本 常见 问题 及 处 理 方法 一 讲述 笔者 遇 到 的 疑难 杂 症 和 解决 方法 


本 章 小 结 


图 6-1 本 章 知 识 结 构图 


由 于 目前 Android 2.3 的 手机 在 市 场 上 占 比 已 经 不 足 5% 了 ， 所 以 本 
章 中 的 内 容 和 示例 是 基于 Android 4.4 的 操作 系统 ， 主 要 介绍 Appium 基 


于 UIAutomator 进 行 目 动 化 测试 的 知识 ， 不 详细 介绍 基于 Selendroid 的 知 
识 。 此 外 关于 Appium 在 iOS 上 的 应 用 本 章 中 不 涉及 ， 需 要 了 解 i0S 相 关 
知识 的 读者 请 通过 其 他 方法 查找 。 


6.1 Appium 框 架 概况 


Appium 是 一 个 开源 的 、 跨 平台 的 自动 化 测试 框架 ， 该 框架 适用 于 
Native Application、Mobile Web Application 或 Hybrid Application 的 自动 
化 测试 。Native Application 指 的 是 基于 智能 手机 本 地 操作 系统 如 iOS 和 
Android 并 使 用 原生 编程 语言 (如 Android 上 使 用 Java) 编写 并 运行 的 第 
三 方 应 用 程序 。Mobile Web Application 指 的 是 基于 Web 的 系统 和 应 
用 。Hybrid Application 指 的 是 在 手机 原生 应 用 程序 中 租 入 了 
Webview， 通 过 Webview 可 以 访问 网 页 的 内 容 。 


6.1.1 Appium 织 构 原 理 
Appium 是 在 手机 操作 系统 目 带 的 测试 框架 基础 上 实现 的 ，Android 
和 iOS 的 系统 上 使 用 的 工具 分 别 如 下 : 


.Android (版 本 >4.2) : UIAutomator，Android 4.2 之 后 系统 自 带 的 
UTI 目 动 化 测试 工具 。 

.Android (版 本 <4.2) : Selendroid， 基 于 Android Instrumentation 框 
架 实 现 的 目 动 化 测试 工具 。 

-iOS: UIAutomation，iOS 系 统 上 自 带 的 UI 自动 化 测试 工具 。 

Appium 的 架构 原理 如 图 6-2 所 示 ， 由 客户 端 (Appium Client) 和 服 


务 器 (Appium Server) 两 部 分 组 成 ， 客 户 端 与 服务 器 端 通过 JSON Wire 


Protocol 进 行 通 信 。 


UIAutomator 
Appium Server 


Test Scripts 


Appium Client 


UlAvuiomation 


Node,js Bootstrap.js 


图 6-2 ”Appium 的 架构 原理 
图 6-2 中 各 部 分 的 作用 及 含义 如 下 : 


(1) Appium 服 务 器 。Appium 服 务 器 是 Appium 框 架 的 核心 。 它 是 
一 个 基于 Node.js 实 现 的 HTTP 服 务 器 。Appium 服 务 器 的 主要 功能 是 接受 
从 Appium 客 户 端 发 起 的 连接 ， 监 听从 客户 端 发 送 来 的 命令 ， 将 命令 发 
送 给 bootstrap.jar 〈iOS 手 机 为 bootstrap.js) 执行 ， 并 将 命令 的 执行 结果 


通过 HTTP 应 答 反 馈 给 Appium 客 户 端 。 


(2) Bootstrap.jar。Bootstrap.jar 是 在 Android 手 机 上 运行 的 一 个 应 
用 程序 ， 它 在 手机 上 扮演 TCP 服 务 器 的 角色 。 当 Appium 服 务 器 需要 运 
行 命令 时 ，Appium 服 务 器 会 与 Bootstrap.jar 建 并 TCP 通 信 ， 并 把 命令 发 


送 给 Bootstrap.jar; Bootstrap.jar 负 责 运 行 测试 命令 。 


六 


(3) Appium 客 户 端 。 它 主要 是 指 实现 了 Appium 功 能 的 WebDriver 
协议 的 客户 端 Library， 它 负责 与 Appium 服 务 器 建立 连接 ， 并 将 测试 脚 
本 的 指令 发 送 到 Appium 服 务 器 。 现 有 的 客户 端 Library 有 多 种 语言 的 实 

包括 Ruby 、Python 、Java 、JavaScript (Node.js) 、Object C、PHP 
和 C#。Appium 的 测试 是 在 这 些 Library 的 基础 上 进行 开发 的 。 


(4) Session。Appium 的 客户 端 和 服务 端 之 间 进 行 通信 都 必须 在 一 
个 Session 的 上 下 文中 进行 。 客 户 端 在 发 起 通信 的 时 候 首 移 会 发 送 一 个 
叫 作 *Desired Capabilities” 的 JSON 对 象 给 服务 器 。 服 务 器 收 到 该 数据 
后 ， 会 创建 一 个 session 并 将 session 的 ID 返回 到 客户 端 。 之 后 客户 端 可 以 
用 该 session 的 ID 发 送 后 续 的 命令 。 


(5) Desired Capabilities。Desired Capabilities 是 一 组 设置 的 键 值 对 
的 集合 ， 其 中 键 对 应 设置 的 名 称 ， 而 值 对 应 设置 的 值 。Desired 
Capabilities 主 要 用 于 通知 Appium 服 务 器 建立 需要 的 Session， 其 中 一 些 
设置 可 以 在 Appium 运 行 过 程 中 改变 Appium 服 务 器 的 运行 行为 。 关 于 
Desired Capabilities 的 内 容 将 在 6.2.3 市 详细 阐述 。 


Appium 在 Android 上 基于 UIAutomator 实 现 了 测试 的 代理 程序 
(Bootstrap.jar) ， 在 iOS 上 基于 UIAutomation 实 现 了 测试 的 代理 程序 
(Bootstrap.js) 。 当 测试 脚本 运行 时 ， 每 行 WebDriver 的 脚本 都 将 转换 

成 Appium 的 指令 发 送 给 Appium 服 务 器 ， 而 Appium 服 务 器 将 测试 指令 交 
给 代理 程序 ， 将 由 代理 程序 负责 执行 测试 。 比 如 脚本 上 的 一 个 点 击 操 


作 ， 在 Appium 服 务 器 上 都 是 touch 指 令 ， 当 指令 发 送 到 Android 系 统 
时 ，Android 系 统 上 的 Bootstrap.jar 将 调用 UIAutomator 的 方法 实现 点 击 
操作 ; 而 当 指 令 发 送 到 iOS 系 统 上 时 ，iOS 的 Bootstrap.js 将 调用 
UIAutomation 的 方法 实现 点 击 操作 。 由 于 Appium 有 了 这 样 的 能 力 ， 同 
样 的 测试 脚本 可 以 实现 跨 平 台 运 行 。 


6.1.2 ”Appium 框 架 的 优 缺 点 


Appium 框 染 的 优点 如 下 : 


:Appium 支 持 多 种 应 用 程序 的 测试 。 它 可 以 测试 移动 Native App、 
Hybrid App 和 Web App。 


被 测试 的 应 用 程序 不 需要 特殊 编译 。Appium 的 测试 对 象 一 般 不 需 
要 做 特殊 修改 ， 如 不 需要 引入 任何 额外 的 测试 SDK， 不 需要 添加 任何 
的 权限 ， 也 不 要 求 被 测 程序 与 脚本 的 签名 一 致 ， 所 以 可 以 直接 对 发 布 
的 程序 进行 测试 。 但 Hybrid App 测 试 可 能 需要 做 一 点 儿 修 改 ， 有 具体 情 
况 会 在 关于 Hybrid App 测 试 的 6.3.4 节 中 提 到 。 


-Appium 的 脚本 不 限制 语言 和 工具 。 由 于 Appium 的 客户 端 文 持 多 
种 测试 语言 ， 测 试 人 员 可 以 选择 熟悉 的 语言 开发 测试 脚本 ， 而 其 他 的 


测试 工具 一 般 只 能 使 用 特定 的 语言 。 


“Appium 文 持 应 用 之 间 跳 转 的 测试 。 它 可 以 用 于 测试 多 个 应 用 程序 
相互 交 户 的 场景 。 


:Appium 是 一 个 跨 平 台 的 测试 框架 ， 可 以 使 用 同一 个 API 开 发 出 在 
Android 和 iOS 上 都 可 以 运行 的 脚本 。 


Appium 的 缺点 如 下 : 


该 工具 必须 连接 电脑 才能 实施 自动 化 测试 ， 遇 到 需要 脱 机 执行 的 
场景 就 不 能 满足 需求 。 


该 工具 只 能 用 于 UI 的 目 动 化 测试 ， 在 很 多 情况 下 测试 验证 只 能 通 


6.2 Appium 框 染 工 作 解 析 


从 前 一 节 内 容 中 可 以 知道 Appium 测 试 框架 在 运行 的 时 候 需 要 搭建 
一 个 基于 Node.js 的 服务 器 。 本 世 选 择 以 Window 7 操作 系统 作为 测试 环 
境 ， 以 Python 2.7 作 为 开发 语言 ， 测 试 手机 选择 LG Nexus 5 (Android 
4.4.4) 搭建 自动 化 测试 环境 ， 并 且 在 该 环境 的 基础 上 运行 示例 脚本 。 


6.2.1 Appium 环 境 搭建 


Appium 环 境 搭建 的 具体 步骤 如 下 : 
1.Android 运 行 环境 准备 


在 Android SDK 安 装 结束 后 ， 右 击 “ 我 的 电脑 *"， 选 择 “ 属 性 ” “高 级 
系统 设置 " >“ 环境 变量 *， 在 系统 变量 里 面 ， 添 
加 “ANDROID_HOME” 的 变量 ， 并 把 Android SDK 的 安装 路 径 设置 为 该 
变量 的 值 ， 如 图 6-3 所 示 。 


%USERPRDFILE%YAppDatavLocalATemp 
WUSERPROFILEN\Applata\Local\Temp 


cr Nappium' Appiun 
Ge ng Files\Lenovo\Communi.. 


i | 


图 6-3 ”Android SDK 环 境 变 量 设置 
2. 安 装 Python 


eg 页 面 下载 最 新 Python2.7 的 安 


参考 图 6-3 中 环境 变量 的 设置 方法 ， 将 Python 的 安装 路 径 添 加 到 系 
统 变量 的 *PATH” 中 。 


_ po 
启动 一 个 命令 


J 窗口， 输入 “python-V”， 如 能 正确 显示 版 本 号 ， 则 
说 明 环 境 配置 正确 。 


@ 提示 ”由 于 笔者 使 用 的 是 python2.7.11， 本 书后 续 的 例子 都 将 
使 用 Python2.7 的 语法 ， 如 读者 安装 的 是 Python3.5， 脚 本 语法 上 的 差别 
请 到 Python 官网 查询 。 


3. 安 狗 Node.js 


进入 https:Wnodejs.org/en/ 下 载 并 安装 Node.js。 


人 @@ 是 示 “Nodejs 并 不 是 必须 安装 的 ， 由 于 在 稍 后 的 章节 中 


会 提 
到 通过 命令 行 的 方式 启动 Appium 服 务 器 ， 这 种 方式 需要 安装 一 个 独 
的 Node.js。 


4. 安 装 Appium 服 务 右 


进入 https://bitbucket.org/appium/appium.app/downloads/ 页 面 ， 下 载 
Windows 版 本 的 Appium 并 安装 。 


@ 注意 ”建议 读者 安装 Appium 1.4.0 及 以 后 的 版 本 ， 笔 者 使 用 


1.4.0 之 前 的 版 本 发 现 稳定 性 不 好 ， 程 序 运 行 过 程 中 经 和 出 现 session 建 


立 失败 ， 导 致 程 序 运行 失败 。 


5. 安 装 Appium 的 客户 端 


局 动 一 个 命令 行 工 具 ， 输 入 “pip install robotframework- 
appiumlibrary”， 然 后 按 回 车 键 ， 等 待命 令 行 提示 安装 成 功 ， 如 图 6-4 所 


修 ° 


my 品 | 回 | 


画 管理 员 : C:\Windows\system32\cmd.exe 


PR\libvsite-packages from sphinx—>mock>=1.0.1->robotframework-appiumlibrary> 
Requirement already satisfied (use —-upgrade to upgrade): snowhallstemmer>=1.1 工 
n c:\python27\lihb\site-packages (from sphinx—->mock>=1.8.1->rohotframework-appium 
library> 

Requirement already satisfied (use -upgrade to upgrade): Pygments»=2.8 in c:\py 
thon27?\lib\site-packages ‘from sphinx—->mnock>=1 .0.1->robotframework-appiumlibrary 
》 


equirement already satisfied (use —-—-upgrade to upgrade): babel>=1.3 in c:\pytho 
‘in27\ihb\site—packages from sphinx—>mock»=1.8.1—>robotframework—appiumnlibrary> 
quirement already satisfied (use --upgrade to upgrade): Jinja2>=2.3 in c:Npuyth 
n27\lib\Nsite-packages ‘from sphinx—->mock>=1.8.1->robotframework-appiumlibrary》 
quirement already satisfied (use -—-upgrade to upgrade): alahbasteh《 日 .8 .>= 日 .7 in 
c:\python27\ihb\site-packages (from Sphinx 一 >mock>=1 .日 -1 一 >PobotfPamework-appium1 
ihrary> 
quirement already satisfied (use --upgrade to upgrade): pytz>=Ba in c:\python2 
\ib\site-packages (from babel1>=1.3->sphinx—>mock>=1.8.1—>robhotframework-appium 
library> 
‘Requirement already satisfied (use 一 Upgrade to upgrade): markupsafe in c¢:\pytho 
n27\lihb\site—packages 《from Jinja2>》=2.3—>sphinx—>mnock》=1 .806.1—>robotframework—app 
iumlibrary> 
Installing collected packages: selenium, fppium-Python—Client 
Running setup.py install for fppium-Python-—Client ... done 
Successfully installed fppium-Python-Client-8.21 selenium-2.50.8 


C:\sers\alexsczhong> 


图 6-4 ”安装 Appium Client 示 意图 


至 此 ，Appium 脚 本 运行 所 必需 的 程序 天 安装 完毕 了 。 读 者 可 以 稳 
试 通过 以 下 两 种 方式 局 动 Appium 服 务 右 。 


第 一 种 方式 是 通过 点 击 Appium 安 装 路 径 下 的 appium.exe 直 接 局 动 
可 视 化 界面 ， 然 后 单 击 界面 最 右边 的 小 火箭 按钮 ， 使 用 默认 的 配置 局 


动 Appium 服 务 右 ， 局 动画 面 如 网 6-5 所 示 。 


第 二 种 方式 是 通过 命令 行 启动 。 局 动 一 个 命令 行 窗口 ， 将 当前 路 
径 切 换 到 Appium 安 装 路 径 下 的 \node_modulesvappiumbin 目 未 下 ， 输 入 
命令 “node appium.js--session-override”， 单 击 回 车 键 启 动 ， 启 动画 面 如 
图 6-6 所 示 。 


叫 | 回 | 歇 


© Sm 


友 Appium 


生意 


上 


> Checking if an update is available 

> Update not available 

> Launching Appium server with command: CN\appium\Appium\node.exe lib\server\main.js --address 127.0.0.1 —port 4723 --platform-name 
Android --platform-version 19 --automation-name Appium --device-name "Coolpad9976D-0x02a2b8c5" --log-no-color 


> info: Welcome to Appium vL4.16 (REV ae6877eff263066b26328d457bd285c0cc62430d) 

> info: Appium REST http interface listener started on 127.0,0,1:4723 

> info: [debug] Non-default server args: 
{“address*:"127.0.0.1","logNoColors":true,“deviceName":"Coolpad9976D-Ox02a2b8c5”,"platformName":"Android","platformVersion":"19","automati 
onName":"Appium"} 

> Info: Console LogLevel debug 


图 6-5 ”通过 UI 界面 启动 Appium 服 务 器 


: Welcome to hppium vi.4.16 〈REU ae6877eff263966h26328du457hdu285cBcc6243Bd) 
: hppium REST http interface listener started on @.0.0.8:4723 


: Console LogLevel: debug 


图 6-6 ”通过 命令 行 局 动 Appium 上 服务 妖 


er 提示 “第 二 种 局 动 方式 的 “--session-override” 人 参数 非常 重要 ， 
如 宁 不 设置 该 参数 ， 那 么 当 测 试 异 党 退出 时 ，Appium 服 务 硕 的 session 
可 能 还 存在 ， 下 一 条 用 例 和 党 试 建立 session 就 会 失败 。 


笔者 在 实际 项 目 中 ， 更 加 倾向 于 使 用 第 二 种 方法 。 由 于 目 动 化 测 
斌 服务器 都 是 部 署 在 一 台 专 用 于 运行 目 动 化 测试 的 机 器 上 的 ， 电 脑 重 
局 后 需要 让 Appium 服 务 器 目 动 启动 ， 此 时 通过 命令 行 的 方式 启动 会 更 
便捷 。 


6.2.2” HelloWorld 测试 示例 


本 将 在 6.2.1 搭 建 的 测试 环境 的 基础 上 ， 开 发 一 个 简单 的 测试 脚 
本 ， 该 脚本 将 Android 系 统 日 市 的 电话 本 作为 被 测 对 象 ， 通 过 目 动 化 测 
试 添加 一 条 联系 人 。 


首先 我 们 需要 创建 一 个 脚本 文件 ， 并 搭建 出 基本 的 用 例 结 构 ， 损 
作 步 又 如 下 : 


步骤 1: 创建 一 个 名 为 helloworld.py 的 Python 脚本 。 


步骤 2: 通过 Python 的 任意 集成 编辑 器 或 者 文本 编辑 器 打开 测试 肢 
本 ， 添 加 一 个 叫 作 “HelloWorld” 的 类 ， 使 该 类 继承 自 python 的 测试 类 


unittest. TestCase ° 
步骤 3: 在 该 类 中 添加 一 个 叫 作 "test_addContact”" 的 方法 。 


步骤 4: 在 测试 脚本 的 后 面 添加 文件 的 main 入 口 ， 并 在 其 之 后 通过 
unittest.TestLoader () .loadTestsFromTestCase () 将 “HelloWorld” 类 中 
的 用 例 进行 加 载 。 此 时 helloworld.py 文 件 的 代码 如 代码 清单 6-1 所 示 。 


代码 清单 6-1 helloworld.py 的 示例 


# -*- Coding: utf-8 -*- 
import sys 
import os 


Import unittest 
from time import Sleep 
class Helloworld(unittest.TestCase): 
def test_addContact(self): 
pass 
if name == ' main _' 
suite = unittest,.TestLoader().loadTestsFromTestCase(Hellowor]ld) 
unittest.TextTestRunner(verbosity=2).run(suite) 


有 了 基本 框 染 后 ， 接 下 来 就 古 往 测 试 方法 中 添加 Appium 的 测试 肢 
本 了 。 


测试 脚本 开发 按 以 下 步 又 进行 : 


步骤 1: 在 脚本 开始 位 置 处 添加 对 Appium 的 Python 客户 端 库 的 引入 
操作 ， 需 要 添加 的 代码 如 下 : 


from appium import webdriver 


步骤 2: 在 “test_addContact" 方 法 中 添加 一 个 字典 变量 ， 在 本 文中 叫 
作 desired_caps， 问 desired_caps 添 加 如 下 面 的 代码 示例 所 示 的 键 与 值 。 
添加 的 每 一 个 键 值 都 对 应 Appium 的 Desired Capabilities 中 的 一 个 设置 。 
其 中 “appPackage” 为 被 测 对 象 的 包 名 ,，“appActivity” 的 值 为 被 测 程序 启 
动 时 的 Activity。 获 取 appPackage 和 appActivity 的 方法 是 将 调试 手机 连接 
到 电脑 上 ， 启 动 一 个 命令 行 窗口 ， 刍 入 命令 “adb logcat>log.txt” 并 回 
车 ; 然后 手动 单 击 被 测 应 用 程序 的 图 标 来 局 动 应 用 程序 ， 当 程序 启动 
后 在 命令 行 窗 口 按 下 "Ctrl+C” 键 结束 日 志 ， 用 文本 编辑 器 打开 log.txt 驻 
件 ， 在 日 志文 件 中 查找 关键 字 “Start proc”"， 在 该 关键 字 后 可 以 看 到 启动 


的 进程 的 appPackage 和 appActivity。appPackage 的 代码 
为 “com.android.contacts”，appActivity 的 代码 


为 “.activities.PeopleActivity”。 


I/ActivityManager( 441): Start proc com.android.contacts for activity com. 
android.contacts/.activities.PeopleActivity: pid=3687 uid=10000 gids={50000, 
3003，1015，1028} 


“deviceName” 为 连接 的 测试 手机 的 名 称 ， 该 名 称 可 以 通过 命令 “adb 
devices” 获 取 到 。 本 例 使 用 的 完整 Desired Capabilities 如 代码 清单 6-2 所 


不 o 
代码 清单 6-2 ”Desired Capabilities 的 示例 


desired caps = 人 

desired caps['platformName'] = 'Android ' 

desired caps['platformVersion'] = '4.4.4" 

desired caps['appPackage'] = 'com.android,.contacts' 
desired caps['appActivity'] = '.activities.PeopleActivity' 
desired caps['deviceName'] = '052abd630a670a6a' 


步骤 3: 以 desired_caps 作 为 参数 初始 化 Webdriver 连 接 ， 需 要 添加 的 
代码 如 下 面 的 代码 所 示 。 其 中 第 一 个 参数 是 服务 器 的 耳 和 端口 组 成 的 
URL， 本 例 中 使 用 当前 电脑 运行 Appium 服 务 器 ， 所 以 IP 为 127.0.0.1， 
而 端口 则 可 以 在 Appium 服 务 器 启动 前 指定 ， 并 且 在 Appium 运 行 起 来 时 
会 打印 在 日 志 里 面 内 ， 详 情 请 参考 前 文 的 图 6-5 和 图 6-6。 当 脚本 运行 到 
此 处 时 可 以 看 到 Appium 服 务 器 开始 建立 ， 并 且 手 机 上 会 启动 被 测试 应 
用 程序 。 


# 初 始 化 


AppIium 连 接 


driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_ caps) 


步骤 4: 将 测试 手机 连接 到 电脑 上 ， 找 到 Android SDK 安 装 目录 下 
的 toolvuiautoma-torviewerbat， 双 击 运行 该 脚本 ， 当 UI Automator 
Viewer 运 行 起 来 时 ， 将 看 到 如 图 6-7 所 示 的 画面 。 单 击 图 中 所 示 工 具 条 
上 的 第 二 个 按钮 ， 在 UI Automator Viewer 中 可 以 看 到 当前 手机 上 显示 的 
画面 。 扣 击 画 面 中 某 个 控件 时 ， 在 右边 的 控件 栏 可 以 看 到 画面 对 应 的 
控件 树 ， 以 及 控件 的 信息 。 通 过 这 样 的 方法 就 可 以 获取 控件 的 信息 ， 
这 些 信息 将 被 用 在 测试 脚本 中 。 


rr ER ze 一 一 
下 上 UT Automator Viewer 刁 | 回 | 又 


全 咽 咽 国 


[0,219][1080,1776] 
ut [0,219][1080,1776] 
ayout [0,219][1080,1776] 
JIview [0,219][1080,1776] 
全 有 联系 人 。 LinearLayout [0,219][1080,1776] 
10) TextVicwi 员 有 联系 人 。 [342 363][738,451] 
‘1) LinearLayout [342,568][738.1756] 
(0] Button: 创 尘 新 联 蒜 人 [342,553][738,712] 
(1 Button: 登 录 帐 户 [342.757][738.901] 
全 Buttom: 导 入 联系 人 [342.946][7381090] 一 


* 


登录 帐户 


导入 联系 人 Node Detail 
MN indax 0 


text 创建 新 联系 人 

resource-id com.android.contacts:id/cre 
class android.widgetLButton 
package comandroid.contacts 
content-desc 

chackable false 

checked foalse 

clickable true 

cnebled true 


focusabla true 
4 wi 


图 6-7 UI Automator Viewer 运 行 示 意图 


步骤 5: 将 收集 到 的 控件 信息 ， 在 测试 脚本 中 调用 Webdriver 提 供 的 
方法 先 找 到 对 应 的 控件 ， 然 后 操作 控件 。 在 本 例 中 ， 当 电话 本 程序 运 
行 起 来 后 ， 首 先是 找到 “创建 新 联系 人 ”的 按钮 并 单 击 ， 示 例 的 脚本 如 
代码 清单 6-3 所 示 。 


代码 清单 6-3 “创建 新 联系 人 ”按钮 的 代码 示例 


# 查 找 创建 新 联系 人 按钮 


createContactButton = None 


try : 
# 如 果 手 机 没有 联系 人 ， 则 通过 


create_contact_button 来 创建 。 
此 处 通过 控件 
id 来 查找 
createContactButton = 
driver.find element_by_id("com.android,.contacts:id/create contact_button") 


except: 
# 否 则 通过 底部 的 添加 联系 人 菜单 来 添加 


createContactButton = 
driver ,find element_by_id("com.android.contacts:id/menu_add_contact") 
# 单 击 创建 按钮 


createContactButton.click() 


@@ 提示 。 Webdriver 提 供 的 查找 控件 的 方法 有 多 种 ， 包 括 通过 控 
件 ID、 控 件 的 文本 、 控 件 的 类 型 和 XPath 等 ， 但 笔者 建议 读者 首先 尝试 
通过 控件 ID 来 查找 。 如 果 没 有 控件 ID， 笔 者 建议 与 开发 者 沟通 让 其 添 
加 。 因 为 控件 的 ID 一 般 很 少 改 变 ， 后 期 维护 成 本 小 ;而 控件 的 文本 等 
信息 变更 的 可 能 性 很 大 ， 每 次 变动 测试 脚本 都 需要 投入 维护 成 本 ， 男 
外 ， 一 个 页 面 会 有 很 多 相同 类 型 的 控件 ， 通 过 控件 的 类 型 不 好 定位 。 


又 6: 步骤 5 的 操作 执行 完毕 后 ， 如 果 手 机 是 第 一 次 创建 联系 
人 ， 则 将 在 页 面 显 示 出 一 个 新 的 Dialog (图 6-8) ， 但 如 果 不 是 第 一 
次 ， 则 不 会 显示 该 Dialog。 此 处 以 显示 该 对 话 框 为 例 ， 测 试 脚本 在 该 步 
又 中 应 该 是 用 某 种 方法 等 待 并 判断 该 对 话 框 显示 后 ， 再 单 击 左边 的 按 
钮 。 如 图 6-8 所 示 ， 选 中 Dialog 后 ， 找 到 该 Dialog 的 一 个 FrameLayout 的 
ID 叫 作 “android: id/content”*， 示 例 先 简单 地 通过 sleep () 方法 等 待 两 


秒 ， 然 后 查看 该 Dialog 是 否 显 示 。 接 着 单 击 左 边 按钮 ， 如 代码 清单 6-4 
所 示 。 


em 人 一 一 < 一 || 日 be 


(0) FrameLayout [27,.715][1053,1130] 

(0) FrameLayout [51,739][1029,1112] 

(0) FrameLayout [51,739][1029,111 

(0) LinearLayout [51,739][1029, 

(0) TextView: 系 统 不 会 备份 您 

(1) View [51,965][1029,968] 

(2) LinearLayout [51,968][10 | 

(0) Button: 本 地 保存 [51,9 

系统 不 会 备份 您 的 新 联系 人 。 要 添加 全 Be 和 
用 于 在 线 备 份 联系 人 的 帐户 吗 ? «ss ss } 


| Node Detail 
index 0 至 
text 本 地 保存 | 


resource-id com.android,contacts:id/left. 
class android.widget.Button 司 | 


package com,android.contacts 
content-desc 

checkable false 辣 
checked false 


clickable 
enabled 


focusahle 
< 


图 6-8 ”弹出 的 新 对 话 框 


代码 清单 6-4 ”确认 对 话 框 显示 时 的 处 理 代码 示例 


# 稍 等 下 ， 手 机 响应 需要 一 点 时 间 


# 此 处 固定 等 待 两 秒 方法 不 可 取 ， 由 于 不 同 的 手机 响应 速度 不 同 ， 脚 本 可 能 会 失败 


# 此 处 仅 是 为 了 示例 ， 在 后 面 章节 中 会 有 更 合理 的 等 待 方法 


sleep(2) 
# 查 看 


Dialog 的 显示 是 否 显示 


try: 
dialog = driver.find element_ by_id("android:id/content") 
# 找 到 “本 地 保存 ”按钮 并 点 击 


saveLocal = driver.find element_by_id( 
"com.android,.contacts:id/left_button") 
SaveLocal, click() 
sleep(2) 
except: 
# 如 果 找 不 到 


Dialog 或 者 


button, 就 会 跳 转 到 这 里 


print("no dialog found") 


步 又 7， 当 上 一 步 结束 时 ， 屏 幕 会 显示 出 一 个 新 的 Activity， 在 这 个 
Activity 中 将 添加 联系 人 的 姓名 和 电话 ， 然 后 保存 ， 如 代码 清单 6-5 所 
示 。 在 这 里 使 用 控件 的 文本 来 查找 控件 ， 使 用 send_keys 方 法 往 文 本 框 
中 输入 文本 ， 最 后 截取 的 图 片 如 图 6-9 所 示 。 


代码 清单 6-5 ”添加 联系 人 的 代码 示例 


sleep(2) 
# 点 击 姓名 ， 并 输入 。 此 处 是 通过 控件 的 文本 来 找到 的 


name = driver.find element_by_name (U" 姓 名 


Li 

name.click() 
name.send_keys("appiumTest") 
# 点 击 电话 输入 框 ， 并 输入 。 注 意 此 处 是 通过 找到 一 组 控件 ， 并 操作 第 


n 个 控件 ， 


n 从 


9 开始 。 


telephoneControls = driver.find elements_by_name(U'" 电 话 


telephoneControls[1].click() 
telephoneControls[1].send keys("01012345678") 
# 保 存 一 个 屏幕 截图 


driver.save_screenshot("afterinput.png") 
# 单 击 完成 按钮 


completeButton = driver.find element_by_id("com.android.contacts:id/icon") 
completeButton.click() 


A 完成 

仅 保 存在 手机 中 ， 不 同步 联系 .… 
appiumTest 

appium sample 


-1 | MC EH AT 
th = 一 二 


电话 


010 1234 5678 


图 6-9 ”添加 联系 人 画面 


步骤 8: 在 测试 脚本 最 后 添加 蚤 证 的 断言 以 及 屏 医 截图 ， 本 例 中 难 
证 的 内 容 是 添加 的 联系 人 信息 是 否 与 预期 输入 的 一 致 ， 并 截 岁 以 备 后 


续 人 工 检 查 。 示 例 代码 如 代码 清单 6-6 所 示 。 
代码 清单 6-6 ”验证 方法 的 示例 代码 


# 验 证 添加 的 联系 人 信息 是 否 与 预期 输入 一 样 


barTitle = driver.find element_by_ id("android:id/action_bar_title") 
self.assertEqual(barTitle.text, "appiumTest") 

contactDatas = driver.find elements_ by_id("com.android.contacts:id/data") 
self.assertEqual(contactDatas[0].text, "010 1234 5678") 

# 最 后 保存 一 个 截图 用 于 人 工 检查 


driver.save_screenshot("newContact.png") 


这 样 ， 测 试 脚本 就 开发 完成 了 ， 将 测试 脚本 保存 。 接 下 来 按 前 一 
节 描 述 的 方式 启动 Appium 服 务 器 ， 男 外 启动 一 个 命令 行 窗 口 ， 在 命令 
行 中 切换 到 helloworld.py 的 保存 目录 下 ， 运 行 “python helloworld.py” 即 
可 将 测试 脚本 运行 起 来 。 


@ 提示 完整 的 Helloworid 测 试 脚本 可 以 通过 网 址 
http://tmq.qq.com/code_for_newbook/six.zip 下 载 得 到 。 


以 上 测试 脚本 只 是 一 个 简单 的 示例 ， 仅 用 于 让 刚 接触 Appium 的 读 
者 知道 如 何 入 手 去 写 一 个 Appium 的 测试 脚本 。 该 示例 的 稳定 性 不 好 ， 
比如 在 该 例子 中 直接 固定 等 待 两 秒 ， 手 机 的 啊 应 是 不 相同 的 ， 固 定 等 
待 时 间 的 方式 不 可 取 ; 另外， 没有 对 测试 脚本 运行 过 程 中 出 现 异常 的 
情况 进行 处 理 ， 如 以 上 脚本 中 任意 步 又 出 现 异常 ， 就 可 能 导致 整个 肢 


本 运行 中 断 ， 这 些 显然 不 是 我 们 期 户 的 。 这 些 问题 的 解决 方法 将 在 6.3 
广 的 项 目 实践 中 进行 详细 阐述 。 


6.2.3 ”Desired Capabilities 的 说 明 


Desired Capabilities 人 简单 来 说 丈 是 一 组 设置 ， 这 些 设 置 可 以 让 测试 
脚本 控制 Appium 的 运行 行为 。 下 面 瓯 逐个 对 Desired Capabilities 中 的 设 
置 进 行 曾 述 。 


首先 看 与 Appium 服 务 器 相关 的 Capability， 表 6-1 中 的 Android 和 iOS 
两 个 平台 都 是 有 效 的 设置 。 


接 下 来 是 仅 对 Android 测 试 有 效 的 一 些 设置 ， 见 表 6-2。 


表 6-1 与 Appium 服 务 器 相关 的 Capability 


rE EL 
automation Name Appium 使 用 哪 一 个 测试 引擎 ， 如 果 测 试 手 机 | Appium (默认 )， 或 者 
是 Android 并 目 在 小 于 API Level 17 的 情况 下 , | Selendroid 
则 automationName 需要 设置 为 “Selendroid ” 


i0S，Android 或 Firefox 
OS，null (默认 ) 


platformVersion — 手机 系统 版 本 如 4.4.4，null (默认 ) 


deviceName 例 如 : Nexus 5，null 
(默认 ) 
App 否 指向 .apk 文 件 ， 或 者 包含 有 .apk 的 ZIP 文 | Di:vtencentmap.apk 或 
件 的 本 地 路 径 或 http URL，Appium 在 运行 |http://testserver/tencen- 
时 会 首先 尝试 安装 apk， 然 后 开始 测试 。 在 |tmap.apk，null (默认 ) 
测 试 Android 时 ， 如 果 设 置 了 appPackage 和 
appActivity， 则 本 Capability 将 被 忽略 
browserName 手机 网 页 测试 时 浏览 器 的 名 称 。 如 果 是 测试 | 测试 :OS 和 Chrome 时 值 
手机 应 用 程序 ， 本 Capability 应 该 为 空 为 Safan， 测 试 Android 时 
值 为 Browser，null (默认 ) 
Appium 服务 器 等 待 Appium 客户 端 发 送 新 消 | 60 (默认 ) 
息 的 时 间 ， 单 位 为 秒 ， 超 过 设置 的 时 间 没 有 收 到 
新 消息 时 ，Appium 服务 器 会 认为 客户 端 退 出 了 


PlatformName 


autoLaunch Appium 服务 器 是 否 默 认 安 装 被 测 应 用 程序 并 | true (上 默认) 
且 自 动 启动 该 程序 

language ( 仅 模 拟 器 使 用 ) ei 例如 : 在 ，null (默认 ) 

locale 例如 : 在 CA,null( 默 认 ) 

udid 在 多 设备 同时 与 一 台 
脑 连接 时 必须 制定 

orientation LANDSCAPE 或 PORT- 
RAIT，null (默认 ) 

autoWebview false (默认 )，true 

noReset :一 个 Session 开始 前 不 重 置 被 测 程 序 的 状态 false (默认 )，true 

fullReset iOS 通过 删除 模拟 器 目录 来 重 置 程序 状态 。 false (默认 )，true 


Android 通过 印 载 程序 的 方式 重 置 程序 状态 ， 而 
且 在 session 结束 的 时 候 还 会 印 载 程序 


表 6-2” 仪 对 Android 测 试 有 效 的 设置 


appActivity 被 测 应 用 程序 启 了 和 Activity 的 名 称 。 该 | com.android.contacts/. 
名 称 在 程序 启动 的 时 候 从 Logcat 日 志 中 找到 ,| activities PeopleActivity 或 
详细 获取 步骤 可 以 参考 62.2 节 。 如 上 一 节 中 电 | 者 activities PeopleActivity 
话 本 的 Activity 在 Logcat 显示 为 “com.android. 
contacts/_activities PeopleActivity "， 则 对 应 的 


appActivity 为 “ activities.PeopleActivity” 


( 续 ) 
Capability 名 称 是否 为 必 填 项 描述 值 
appPackage 被 测 应 用 程序 的 包 名 。 同 appActivity 的 获取 方 | 例如 : com.android. 
法 一 样 ， 但 是 去 “/” 之 前 的 文本 ,如 电话 本 肩 动 | contacts 
时 日 志 为 “com.android.contacts/.activities.People- 
Activig“， 那 么 包 名 需要 写 “com android contacts” 


appWaitActivity 测试 时 需要 等 待 显 示 的 Activity 的 名 称 例如 : SplashActivity， 
null (默认 ) 
appWaitPackage 测试 时 需要 等 待 运 行 的 包 名 称 null ( 歌 认 ) 
deviceReadyTimeout 等 待 测试 设备 Ready 的 超时 时 间 ， 单 位 为 秒 5 (默认 ) 
autoWebviewTimeout 等 待 WebView 的 Context 变 为 active 的 时 间 , | 2000 (默认 ) 


单位 为 毫秒 
是 否 支 持 unicode 的 键盘 。 如 果 在 测试 脚本 输 | false (默认 )，true 
人 时 需要 输入 中 文 ， 请 将 该 设置 设 为 true 
是 否 在 测试 结束 后 将 键盘 重 普 为 系统 默认 的 | false (默认 )，true 
输入 法 。 如 果 该 resetKeyboard 为 人 lse、 那 么 在 
测试 结束 后 输入 法 还 是 Appium 的 测试 输入 法 ， 
测试 手动 输入 时 不 会 弹出 键盘 ， 需要 进入 系统 
设置 将 输 大 法 改 回来 才能 正常 输入 。 但 是 如 果 
resetKeyboard 为 true 的 话 ， 每 个 session 结束 后 
都 会 重 置 键盘 ， 测 试 时 间 会 增加 


dontStopAppOnReset 在 通过 ADB 启动 其 他 被 测 程序 时 ， 保 持 | false (默认 )，true 
否 


unicode Keyboard 


resetKeyboard 


当前 正在 运行 的 应 用 程序 的 进程 。 另 外 ， 如 
果 被 测 程序 是 被 别 的 应 用 程序 启动 ， 将 
dontStopAppOnReset 设 置 为 false。 则 Appium 
通过 ADB 启动 被 应 用 程序 的 过 程 中 ， 可 以 使 正 
在 运行 的 程序 保持 为 Alive 状态 。 简 单 地 说 就 是 
dontStopAppOnReset 设置 为 rue，Appium 在 运 
行 adb shell am start 命令 时 不 带 -S 标志 ， 否 则 
运行 adb shell am start 命令 时 会 加 上 -S 标志 
当 设 置 了 该 Capability 时 ，Appium 将 调用 | false ( 歌 认 )，true 
UIAutomator 的 ignoreUnimportantViews() 方法 ， 
因此 Accessibility commands 在 运行 时 会 忽略 一 
些 控 件 ， 这样 可 以 使 测试 的 运行 速度 加 快 。 但 
是 这 些 被 忽略 的 控件 将 不 再 对 测试 可 见 ， 这 意 
味 着 可 能 导致 脚本 因为 革 些 控件 找 不 到 而 失败 
停止 Android 的 Watcher，Android 将 不 再 监 | false (默认 )，true 
控 程 序 的 ANR 和 Crash， 这 将 减少 Android 的 
CPU 消耗 。 该 Capability 只 对 基于 UIAutomator 
的 测试 有 效 
null (默认 ) 
( 仅 模 拟 器 使 用 ) 等 待 模拟 器 启动 并 与 ADB| ”12000 (默认 ) 
连接 的 时 间 ， 单位 是 毫秒 
( 仅 模 拟 器 使 用 ) 等 待 模拟 器 启动 动画 显示 的 | ”12000 (默认 ) 
时 间 ， 单 位 是 毫秒 


ignore UnimportantViews 


disableAndroidWatchers 


avd 


avdLaunchTimeout 


avdReady Timeout 


Capability 名 称 
avdArgs 


IntentAction 


intentCategory 


intentFlags 


optionalIntentArguments 


是 否 为 必 填 项 


描述 
( 仅 模 拟 才 使 用 ) 模拟 器 启动 使 用 的 其 他 参数 
启动 Activity 的 Intent Action 


启动 的 Activity 的 Intent 类 别 


启动 Activity 的 flag 


启动 Activity 时 其 他 的 一 些 参 数 


值 

null (默认 ) 

android.intent.action 
MAIN (默认 )。 更 多 关 
于 intent action 的 详情 
参考 Android 源 文件 的 
android.content.Intent 类 

android.intent.category 
LAUNCHER (默认 )。 更 
多 关 于 intent category 的 
详情 参考 Android 源 文件 
的 android.content Intent 类 

0x10200000 (默认 ) 
更 多 关于 intent flag 的 详 
情 参 考 Android 源 文 件 的 
android content Intent 类 

更 多 详情 参考 Android 
源 文件 的 android content 
Intent 类 


以 上 是 现 有 Capability 中 的 大 部 分 内 容 ， 主 要 是 关于 Android 测 试 
的 ， 还 有 一 部 分 与 OS 相关 的 Capability 就 不 在 这 里 歼 述 了 ， 感 兴趣 的 读 


者 请 去 Appium 的 官网 查看 。 


@ 提示 。 笔者 主要 使 用 的 Capability 包 括 platformName 、 


platformVersion 、 appPackage 、 appActivity 、 unicodeKeyboard 、 


resetKeyboard 和 newCommandTimeout。 这 些 Capability 基 本 上 已 经 满足 
了 目前 的 测试 需求 。 


6.2.4 Appium API 的 解读 


Appium 的 客户 端 (WebDriver) 提供 的 接口 按 作 用 大 致 可 以 分 为 控 
件 的 查找 、 手 势 操 作 和 系统 操作 ， 本 小节 将 对 测试 过 程 中 最 彰 用 的 部 
分 方法 进行 曾 述 ， 如 末 使 用 的 方法 在 本 文中 没有 提 到 ， 请 查阅 
WebDriver 的 玫 助 文档 或 者 产 代 码 获取 详细 信息 。 


1. 控 件 查 找 API 


WebDriver 提 供 的 方法 可 以 根据 ID、Xpath、Name 、Class Name 、 
Accessbility id 和 UIAutomator 来 查找 控件 ， 详 细 的 方法 和 参数 说 明 见 表 
6-3° 


表 6-3 ”查找 控件 的 方法 和 参数 说 明 


API 


方法 描述 


find element by id(self id ) 

find elements by id(self. id ) 

find element by xpath(self, xpath) 
find elements by xpath(self. xpath) 


find element by name(self, name) 
find elements by name(selt. name) 


通过 控件 的 resource id 来 查找 控件 ，resource id 可 以 
通过 viautomatorviewer 或 者 Appium 的 Inspector 查看 
根据 XPath 来 查找 控件 ，Android Native App 一 般 很 少 
使 用 该 方法 ， 但 常用 于 Web App 和 Hybried App 测试 中 
在 Native App 测试 中 ，Name 参数 就 是 控件 的 Text 


find element by class name(self. name) 


find elements by class name(self. name) 


在 Native App 测试 中 ， 参 数 Name 指 代 控 件 的 类 型 ， 
如 android.view.Text ; 在 网 页 测试 时 指 代 网 页 element 的 
属性 类 名 ， 如 <div class="highlight-java" style="display: 
none; ">...</div> 中 ，class name 为 “highlight-java” 


find element by android uiautomator(self. uia_string) 
find elements by_android uiautomator(self. uia_string) 


find element by accessibility id(self, id) 
find elements by accessibility id(self. id) 


find element by link text(self, link text) 
find elements by link text(self. link_text) 


根据 UIAutomator 的 语法 查找 控件 ,该 方法 是 Web- 
Driver 在 菲 容 Appium 时 才 新 加 的 方法 

根据 控件 的 accessbility ID 来 查找 ，accessbility ID 指 
Native App 控件 的 Content Description ; 若 列 表 的 项 ID 
信息 可 能 都 一 样 ， 则 可 以 让 开发 人 员 为 每 个 列表 添加 一 
个 Content Description 用 于 列表 项 的 查找 

根据 链接 的 文本 查找 控件 ， 仅 用 于 Web App 和 Hybrid 
App 的 测试 


find element by partial link_text(selt link text) 
find elements by partial link text(self link text) 
find element by css selector(self. css_selector) 
find elements by css selector(self. css selector) 


find element by tag name(self, name) 
find elements by tag name(self. name) 


四 注意 


忠 古 列表 项 ， 


根据 链接 的 部 分 文本 查找 控件 ， 
Hybrid App 的 测试 

根据 网 页 element 的 CSS Selector 查找 控件 ， 仅 用 于 
Web App 和 Hybrid App 的 测试 

根据 网 页 element 的 Tag 查找 控件 ， 仅 用 于 Web App 
和 Hybrid App 的 测试 


仅 用 于 Web App 和 


页 面 中 同一 个 ID 的 控件 可 能 不 止 一 个 ， 最 常见 的 情况 
笔者 项 目 中 同一 个 列表 的 列表 项 的 ID 痢 是 一 样 的 。 表 6-3 


中 的 find_element_by_id 是 查找 页 面 中 第 一 个 ID 为 指定 参数 的 控件 ， 返 


回 一 个 控件 ;而 find_elements_by_id 


征 查找 页 面 中 所 有 ID 为 指定 参数 的 


控件 ， 返 回 包含 所 有 满足 条 件 的 控件 列表 。 其 他 的 方法 也 是 同样 的 原 


理 。 


2. 获 取 和 操作 控件 信息 的 API 


测试 过 程 中 和 常常 需要 获取 控件 的 信息 来 进行 测试 验证 。WebDriver 
有 一 个 类 叫 作 WebElement， 所 有 的 控件 都 是 该 类 的 对 象 ， 它 提供 一 些 
专门 的 API 用 于 获取 控件 信息 ， 见 表 6-4。 


表 6-4 获取 控件 信息 的 API 


API 方法 描述 


text(self) 获取 控件 显示 的 文本 信息 ， 如 element.text 


获取 控件 的 Tag 名 称 ， 主 要 是 在 网 页 测试 时 使 用 ， 如 <input></input> 返回 的 Tag 


tag name(self) 
人 名 称 为 input 


click(self) 点 击 控件 ， 如 element.clickO) 

clear(self) 如 果 是 一 个 文本 输入 控件 的 话 ， 该 方法 可 以 清除 控件 的 文本 ， 如 element.clear0 
is_enabled(self) 判断 控件 是 否 可 用 了 ， 如 果 是 可 用 的 ， 则 返回 true 

is_selected(self) 判断 控件 是 否 被 选中 了 ， 如 果 被 选中 了 则 返回 true 

is_displayed(self) 判断 控件 是 否 显示 ， 如 显示 则 返回 true 

se 获取 控件 某 项 Ee 的 值 ， 如 果 该 属性 不 存在 ， 则 会 返回 None， 如 element.get_ 
0 attribute("enabled") 等 同 于 is_enabled0 方法 

parent(self) 返回 控件 的 父 控件 ， 返 回 值 为 一 个 控件 对 象 


模拟 输入 文本 到 控件 中 ,Value 为 输入 的 文本 串 信息 ， 如 textElement. send_ keys (u 
腾讯 地 图 ”) 


send keys(self *value) 


3. 手 势 操 作 API 


WebDriver 为 了 文 持 Appium 手 机 目 动 化 测试 ， 新 增加 了 手机 上 的 手 
势 操 作 方 法 。 这 些 方法 包括 点 击 、 滑 动 屏 幕 、 放 大 缩小 、 拖 上 息 以 及 滚 
动 屏 幕 等 。 表 6-5 撒 述 了 手势 操作 方法 的 功能 和 参数 。 


表 6-5 手势 操作 方法 的 功能 和 参数 


API 


方法 描述 


tap(self, positions, duration=None) 


点 击 屏幕 上 的 位 置 ， 最 多 可 以 $ 个 手指 同时 点 击 ; positions 是 一 
个 列表 ， 每 一 个 列表 项 是 一 个 二 元 组 ， 值 分 别 是 屏幕 上 坐标 的 X 
和 Y 立 ; duration 为 点 击 的 时 间 长 得， 单位 为 毫秒 。 如 果 该 参数 不 提 
供 ， 则 认为 是 点 击 操作 ， 如 果 该 参数 给 定 参 数 ， 则 被 WebDriver 识 
别 为 长 按 操作 ， 如 driver.tap([(100. 20). (100. 60), (100. 100)]. 500) 


swipe(self, start x, start_y, end x, end y, 


duration=None) 


从 屏幕 上 A 点 滑动 到 B 点 ，duration 为 滑动 动作 执行 的 时 间 ， 单 
位 为 毫秒 


flick(self, start_ x, start_y. end x, end y) 


从 屏幕 A 点 快速 地 滑动 到 B 点 


pinch(self, element=None, percent=200, 


steps=50) 


在 某 控 件 上 执行 缩小 操作 ， 默 认 缩 放 比 例 为 200%，step 表示 缩 
小 动作 分 多 少 步 完成 ， 默 认为 50 


Zoom(self， element=None. percent=200, 


steps=50) 


在 某 控件 上 执行 放大 操作 ， 默 认 缩 放 比 例 为 200%，step 表示 放 
大 动作 分 多 少 步 完成 ， 默 认为 50 


scroll(self. orlgin_el, destination_e]) 


从 origin el 控件 滚动 到 destination_ el 控件， 参数 必须 是 两 个 控 
件 ， 而 不 是 控件 信息 


drag and drop(self, origin el. destination el) 


4. 系 统 操 作 API 


把 origin_el 控件 拖 忠 到 destination_el 的 位 置 


WebDriver 提 供 的 系统 操作 API 是 用 于 模拟 操作 和 硬件、 设置 系统 环 


境 或 者 获取 系统 信息 的 方法 ， 


如 按 返 回 键 、 设 置 网 络 和 文件 操作 等 。 


表 6-6 包 含 了 现 有 系统 操作 方法 的 描述 和 参数 说 明 。 


表 6-6” 现 有 系统 操作 方法 的 搞 述 和 参数 说 明 


contexts(self) 
current context(self) 


context(self) 


Keyevent(self keycode. metastate=None) 


press _ keycode(self. keycode. metastate=None) 

long press keycode(self. keycode. metastate=None) 
curent activity(self) 

reset(self) 

pull file(self. path) 

pull folder(seif path) 

push file(self, path. base64data) 


background app(self. seconds) 


1s app_installed(self. bundle_1d) 


install app(self. app_path) 


launch applself) 
close_app{self) 


start activity(self, app_package, app_activity, **opts) 


shake(self) 


方法 描述 
获取 当前 会 话 Session 所 有 可 用 的 上 下 文 (Context)， 关 于 
Context 的 使 用 将 在 6.3.3 节 中 详细 并 述 
获取 当前 会 话 Session 正在 使 用 的 上 下 文 


模拟 发 送 一 个 硬 键 码 到 手机 ，Selendroid 使 用 该 方法 可 以 
模拟 硬件 操作 ， 如 模拟 按 下 返回 键 driver. keyevent(4)。 详 细 
的 keycode 请 通过 网 址 http://developer.android.com/reference/ 
android/view/KeyEvent.html 查询 

模拟 发 送 一 个 硬 键 码 到 手机 ， 如 模拟 按 下 返回 键 driver. 
press_ keycode (4) 

模拟 发 送 一 个 长 按 硬 键 码 到 手机 

获取 当前 正在 显示 的 Activity 信息 

重 置 当前 被 测 程序 到 初始 状态 

拉 取 手机 上 的 一 个 文件 ， 并 以 Base64 格式 编码 返回 文件 数 
据 ; path 为 手机 上 的 文件 路 径 

拉 取 手机 上 的 一 个 目录 . 目录 的 所 有 内 容 会 被 压缩 打包 ， 
并 以 Base64 格式 编码 返回 数据 ; path 为 手机 上 的 目录 路 径 

将 一 个 base64 格式 编码 的 数据 推送 到 手机 的 文件 路 径 : path 
为 手机 上 的 文件 路 径 ， base64data 为 要 推送 的 数据 

将 被 测 应 用 程序 放 到 后 台 持 续 运 行 一 段 时 间 ，seconds 为 持 
续 的 秒 数 

判断 应 用 程序 是 否 安装 。bundle id 是 被 查询 的 应 用 程序 的 
ID. 在 Android 设 备 上 ，bundle id 是 应 用 程序 的 完整 包 名 ， 
如 “com.android.contacts” 

将 app_path 路 径 的 应 用 程序 安装 色 手 机 上 :此 处 的 app_ 
path 需要 人 包含 目录 和 文件 名 ， 如 “C:Mtestapk” 

在 测试 设备 上 启动 Desired Capabilities 中 指定 的 应 用 程序 

如 Desired Capabilities 指定 的 应 用 程序 正在 运行 , 则 关闭 该 
程序 

启动 某 个 Activity， 如 果 该 Activity 不 属于 另外 一 个 未 启动 
的 程序 ， 那么 该 程序 将 被 启动 ， 然 后 该 Activity 被 打开 。 该 方 
法 的 使 用 可 以 参考 adb shell am start 命令 

模拟 晃动 手机 的 事件 


API 


open notifications(self) 


network connection(self) 


set_ network connection(self. connectionType) 


get_screenshot as file(self. filename) 


方法 描述 
打开 消息 通知 栏 ， 该 方法 仅 对 Android API Levell8 以 上 的 
系统 有 效 
返回 当前 网 络 连接 的 类 型 ， 网 络 类 型 参考 appium webdriver 
ConnectionType 
设置 网 络 ，connectionType 的 值 为 ;: 
Value (Alias) |Data| Wifi|Airplane Mode 


0 (None) 10 10 10 
1 (Airplane Mode) |0 |0 |1 
2 (Wifi only) | 为 a bs, 
4 (Data only) EE 


6(Allnetwork on) |1 |1 10 
将 手机 屏幕 截图 并 保存 为 电脑 上 的 文件 ， 和 他 ename 为 文件 的 
路 径 和 名 称 


6.3 ”Appium 框 架 在 腾讯 地 图 中 的 实践 
6.3.1 Appium 接 口 的 封装 


Appium 的 目 动 化 测试 的 过 程 大 部 分 都 是 由 建立 Appium 的 连接 、 查 
找 控 件 、 操 作 探 件 、 等 待 控件 的 显示 、 获 取 探 件 信 息 和 测试 验证 等 步 
又 组 成 的 。 在 地 图 项 目 中 ， 笔 者 对 常用 的 WebDriver 接 口 进 行 了 封装 ， 
将 这 些 方法 放 到 了 一 个 UiHelper 的 类 中 进行 统一 管理 ， 便 于 简化 测试 脚 
本 ， 降 低 开 发 和 维护 的 成 本 。 


1.Appium 连 接 建 立 与 断 开 方法 的 封 浅 


在 6.2.2 节 的 示例 脚本 中 ， 脚 本 在 建立 连接 前 都 提供 一 个 Desired 
Capabilities 的 字典 数据 ， 并 用 它 初 始 化 了 与 Appium 的 连接 。 如 采 读 者 
有 更 多 的 测试 用 例 ， 大 家 应 该 可 以 发 现 初始 化 Appium 连 接 的 代码 的 每 
个 用 例 都 是 必需 的 ， 但 是 Desired Capabilities 基 本 上 很 少 改 变 ， 而 且 这 
部 分 代码 都 是 重复 的 。 因 此 笔者 想到 将 Desired Capabilities 的 数据 独立 
存放 到 文件 中 进行 管理 ， 这 样 既 可 以 重用 ， 也 便于 维护 。Desired 
Capabilities 数 据 的 文件 如 图 6-10 所 示 。 


platformName=Android 

platformVersion=4.4 
deviceName=98952abd638a678a6a 

# 此 处 的 app 不 需要 ， 因 为 需要 动态 的 安装 最 新 的 appl 
#app= 


appPackage=com.android.contacts 
appActivity=.activities.PeopleActivity 
unicodeKeyboard=true 
newCommandTimeout=156 
remoteHost=http://127.96.86.1:4723/wd/hub 


图 6-10 ”Desired Capabilities 配 置 文件 示例 


既然 Desired Capabilities 存 放 到 了 独立 的 文件 内 ， 那 么 Appium 的 初 
化 代码 也 需要 做 相应 的 变更 。 笔 者 将 Desired Capabilities 数 据 的 读 取 
放 到 了 UiHelper 这 个 类 的 _init 方法 中 ， 对 Appium 连 接 的 建立 和 汤 开 
也 进行 了 封装 ， 用 例 可 以 直接 使 用 UiHelper 的 方法 来 完成 Appium 连 接 
的 建立 ， 如 代码 请 单 6-7 所 示 。 


代码 清单 6-7 使 用 UiHelper 建 立 与 Appium 服 务 器 的 连接 示例 


def _ init (self, configPath): 
self.desired caps = {} 
self._ driver = None 
file_object = open(configPath) 
try: 
for line in file object: 
#' #1' 的 行为 注释 


7 忽略 


if(line.startswith("#")): 
continue 
line = line.strip() 
words = line.split("=") 
if(len(words) != 2): 
continue 
if(words[0] == 'app'): 
self.desired caps[words[0]] = PATH(words[1]) 


elif(words[0] == "remoteHost ' ) : 
remoteHost = words[1] 
else: 
self.desired caps[words[0]] = words[1] 
finally: 
file_object.close( ) 
def initDriver(self): 
Self, driver = webdriver.Remote(self.remoteHost, self.desired caps) 
def quitDriver(self): 
if(self._driver): 
self._ driver.quit() 


2. 控 件 碍 找 方法 的 封 猴 


在 6.2.4 节 中 详细 描述 了 控件 查找 的 方法 ， 在 笔者 项 目 中 的 测试 脚 
本 主要 通过 XPath、ID、Name 和 ClassName 来 查找 控件 。WebDriver 提 
供 的 查找 方法 各 不 相同 ， 但 是 对 于 测试 脚本 的 开发 人 员 来 说 ， 使 用 这 
些 方 法 都 是 为 了 查找 控件 ， 因 此 笔者 考虑 将 常用 的 查找 方法 融合 到 一 
起 ， 脚 本 开发 人 员 不 用 显示 调用 WebDriver 中 具体 的 方法 来 查找 控件 ， 
只 需要 调用 同一 个 方法 就 足够 了 。 


经 过 对 WebDriver 的 接口 进行 分 析 ， 发 现 这 些 接口 需要 传 入 一 个 字 
器 


符 率 ， 只 十 传 入 字符 哩 的 格式 有 一 些 不 同 。 例 如 ， 通 过 ID 来 得 找 ， 
数字 符 串 中 会 包含 “: id/ 这 样 的 字符 串 ， 而 通过 XPath 来 查找 ， 参 效 则 


以 /开始 ; 对 于 通过 Name 或 者 ClassName 的 方法 ， 参 数 没 有 明显 的 特 
征 ， 但 在 实际 测试 过 程 中 发 现 使 用 Name 来 进行 查找 的 次 数 明 显 比 较 

多 。 上 所 以 当 判 断 出 不 是 XPath 或 者 ID 时 ， 直 接 通过 Name 查 找 一 次 ， 如 
果 还 找 不 到 控件 ， 再 尝试 通过 ClassName 来 查找 。 封 装 后 的 方法 如 代码 
清单 6-8 所 示 ， 该 方法 用 于 在 当前 页 面 中 查找 单个 控件 。 


代码 清单 6-8 自己 封装 的 控件 查找 方法 


def findElement(self, controlInfo): 
element = "" 
if(controlIinfo.startswith("//")): 
element = self._ driver.find element_ by_xpath(controlInfo) 
elif(":id/" in controlInfo or ":string/" in controlInfo): 
element = self._driver.find element_by_id(controlInfo) 
else: 
# 剩 下 的 字符 串 没有 特点 ， 无 法 区 分 ， 因 此 先 尝试 通过 名 称 查找 


try: 
element = self._driver.find element_by_name(controlInfo) 

except: 
self.logger.logDebug("Cannot find the element by id, try class name") 
# 如 果 通 过 名 称 不 能 找到 ， 则 通过 


ClLass name 查 找 


element = self._driver.find element_by_class_name(controlInfo) 
#self.logger.logDebug("Found the element by: " + controlInfo) 
return element 


在 测试 脚本 中 大 部 分 控件 查找 都 只 需要 调用 该 方法 即 可 实现 ， 此 
外 在 当前 页 面 中 查找 一 组 控件 的 方式 也 是 同样 的 原理 。 调 用 本 方法 的 
示例 如 代码 清单 6-9 所 示 。 


代码 清单 6-9 ”使 用 目 定 义 的 方法 进行 控件 查找 


# 初 始 化 


UiHelper 对 象 ， 并 使 其 与 
Appium 建 立 连接 
uiHelper = UiHelper("deviceConfig.txt") 
uiHelper .initDriver() 

# 通 过 

ID 来 查询 控件 


createContactButton = uiHelper.findElement( 
"com.android,.contacts:id/menu_add_contact") 


# 通 过 控件 文本 来 查找 控件 
name = uiHelper.findElement(u" 姓 名 


1 ) 
# 通 过 控件 的 类 名 ( 


ClassName) 来 查找 画面 中 第 一 个 该 类 型 的 控件 


editText = uiHelper.findElement("android,.widget.EditText") 
# 通 过 


Xpath 查 找 控件 ， 类 似 于 控件 位 置 的 绝对 路 径 


7 较 难 维护 


# 该 方法 一 般 在 


Android 上 很 少 使 


View = uiHelper.findElement( 
"//android.widget.FrameLayout[0]/android,.view.View[0]") 


以 上 方法 是 在 当前 页 面 查找 控件 ， 在 测试 中 还 有 男 外 一 些 需 要 在 
已 知 的 某 个 控件 中 查找 控件 的 情况 。 如 图 6-11 所 示 ， 当 判断 北 未 市 的 离 
线 地 图 是 否 下 载 时 ， 需 判断 列表 项 中 石 边 的 状态 显示 为 “已 下 载 ”。 然 
而 “北京 市 ”字样 的 控件 与 右边 的 “已 下 载 * 字 样 的 按钮 不 在 一 个 TextView 
中 ， 但 是 这 两 部 分 控件 有 一 个 共同 的 父 控件 ， 所 以 测试 脚本 首先 要 碍 
找 某 个 列表 项 中 包含 “北京 市 ”然后 再 在 列表 项 中 判断 “已 下 载 " 束 能 找 
到 ， 这 个 流程 束 需 要 使 用 到 在 某 控 件 中 查找 子 控件 的 方法 。 笔 者 将 这 
类 特殊 作用 的 方法 也 封闭 在 一 起 ， 如 代码 清单 6-10 所 示 。 
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图 6-11 ”离线 地 图 下 载 控 件 布局 示意 


代码 清单 6-10 ”在 控件 中 碍 找 其 他 控件 的 方法 封 疼 


def findElementInParentElement(self, parentElement, childElementInfo): 
element = "" 
if(childElementInfo.startswith("//")): 
element = parentElement.find element_ by_xpath(childElementInfo) 
elif(":id/" in childElementInfo): 
element = parentElement.find element_ by_id(childElementInfo) 
else: 
# 此 处 省 略 其 他 方式 的 代码 


return element 
# 调 用 示例 如 下 : 


Parent = uiHelper.findElement("com.XXXX.XX:id/listItem") 
statusText = uiHelper.findElementInParentElement( 
Parent, "com.XXXX.XX:id/status") 


一 -一 


3.UI 等 待 方法 的 封装 


在 6.2.2 攻 结束 时 提 到 Helloworld 的 脚本 中 的 不 足 之 处 就 是 等 待 的 时 
间 是 固定 的 ， 在 这 里 我 们 将 解决 这 个 问题 。 在 UI 自动 化 测试 中 ， 等 得 
某 状态 到 来 是 很 常见 的 情况 ， 比 如 在 UI 上 操作 了 某 控 件 后 等 待 某 个 
Activity 或 控件 的 显示 ， 人 然后 进行 下 一 步 操作 。WebDriver 近 供 了 
implicitly_wait 方 法 可 以 在 一 定时 间 内 竺 每 控件 的 显示 ， 此 外 Python 语 
言 提供 的 sleep 方 法 也 可 以 用 于 等 待 ， 这 些 方法 都 是 等 竺 固定 的 时 间 。 
脚本 运行 完 竟 需要 等 待 多 长 时 间 明 显 是 不 能 确定 的 ， 例 如 在 网 络 不 稳 
定时 等 得 请 求 返回 的 时 间 会 更 长 ， 男 外 不 同 的 测试 设备 性 能 不 一 样 ， 
等 竺 的 时 间 也 各 不 相同 。 如 果 设 置 一 个 足够 长 的 时 间 当 然 可 以 减少 测 
试 的 失败 ， 但 是 我 们 往往 希望 测试 脚本 能 尽 可 能 快 地 运行 ， 每 次 运行 
都 固定 等 竺 很 长 时 间 束 不 明智 了 。 


WebDriver 提 供 了 一 个 叫 作 WebDriverWait 的 等 待 方法 类 。 该 类 可 以 
提供 Until 方 法 和 unti_not 方 法 ， 这 两 个 方法 需要 用 户 指定 等 待 条 件 和 等 
待 时 间 。Unti 方 法 在 条 件 得 到 满足 时 就 会 中 断 等 每 ， 继 续 后 续 的 步 
又 而 unti_not 方 法 是 在 条 件 不 满足 时 中 断 等 得 。 代 码 清单 6-11 所 示 使 


用 WebDriverWait 的 方法 等 待 com.android.contacts: id/left_button 控 件 的 


显示 ， 最 长 等 待 10 秒 。 


代码 清单 6-11 WebDriverWait 方 法 的 使 用 示例 


from selenium.webdriver.common.by import By 
from selenium.webdriver.support.ui import WebDriverwait 

from selenium.webdriver.support import expected conditions as EC 
#do something then wait for an element shown 


WebDriverwait(self._driver, 10).until(EC.visibility_of_element_located( (By.ID, 
"com.android,.contacts:id/left_button"))) 


如 上 面 的 代码 所 示 ，WebDriverWait 的 使 用 需要 用 到 
expected_conditions.py 中 的 各 种 查询 条 件 ， 包 括 判 断 控 件 是 否 “ 
本 是 否 正 确 或 者 各 种 状态 是 否 与 期 望 状 态 一 致 等， 这 些 查 询 条 件 同 样 
可 以 用 于 Assert 方 法 中 。 详 细 的 碍 询 条 件 这 里 惑 不 再 痪 述 了 ， 感 兴趣 的 
读者 可 以 通过 查看 WebDriver 的 文档 或 者 erexpected_conditions.py 源 人 码 了 
解 。 


在 地 图 项 目 中 ， 笔 者 封 攻 了 一 些 简 单 的 等 待 方法， 原理 与 
WebDriverWait 的 原理 类 似 ， 都 是 将 固定 等 待 的 过 程 分 成 了 多 次 UI 的 检 
查 过 程 ， 封 装 后 的 方法 如 代码 清单 6-12 所 示 ， 该 方法 参数 需要 提供 等 待 
的 控件 信息 和 等 竺 的 秒 数 ， 每 隔 一 秒 束 会 检查 一 下 期 望 的 控件 能 人 否 被 
查询 到 ， 如 果 查 询 到 了 就 立即 返回 ， 如 果 没 有 得 询 到 则 继续 等 待 ， 直 
到 超时 。 对 于 等 待 某 个 控件 消失 也 可 以 采用 同样 的 方式 。 


代码 清单 6-12 ”等 待 方法 的 封装 


def waitForElement(self, elementInfo, period): 
for i in range (0, period): 
sleep(1) 
try: 
self.findElement(elementInfo) 
return 
except: 
continue 
raise Exception("Cannot find %s in %d seconds" %(elementInfo,period)) 


以 上 是 针对 控件 显示 的 等 竺 方法 ， 人 简单 且 实用 。 另 外 ， 在 一 些 特 
殊 情况 下 ， 比 如 在 当前 画面 有 一 个 控件 ID 叫 作 “okButton”， 单 击 该 按钮 
时 会 跳 转 到 男 一 个 画面 ， 在 新 的 画面 中 义 有 一 个 控件 IDM“okButton”。 
此 时 ， 如 有 果 通 过 该 控件 是 否 显 示 再 判断 是 否 该 进行 下 一 步 操 作 ， 脚 本 
整 可 能 出 错 。 在 这 种 情况 下 ， 可 以 使 用 WebDriver 提 供 的 wait_activity 的 


方法 来 等 每 画面 显示 。 


@ 提示 。 使 用 wait_activity 方 法 时 需要 知道 等 得 的 画面 是 什么 
Activity， 笔 者 一 般 会 手动 点 到 需要 等 待 的 画面 ， 然 后 通过 以 下 的 adb 命 
令 来 获取 当前 Activity: adb shell dumpsys 


activitylfindstr“mFocusedActivity” ° 


对 比 WebDriverWait 和 笔者 实现 的 方法 ， 原 理 都 一 样 ， 歼 率 也 相差 
不 大 ， 但 是 笔者 没有 实现 对 状态 的 检查 等 ， 因 此 ，WebDriverWait 更 加 
全 面 一 些 。 建 议 读 者 使 用 WebDriverWait， 但 最 好 将 WebDriverWait 方 法 
进行 二 次 封 朔 ， 让 其 使 用 起 来 更 加 简单 一 些 。 


4. 控 件 信息 验证 方法 的 封装 


在 测试 脚本 中 少不了 对 控件 信息 或 者 状态 的 获取 ， 这 些 方法 大 量 
使 用 在 脚本 的 验证 过 程 中 。 如 上 一 部 分 讲 等 待 时 提 到 的 
expected_conditions 就 比较 好 用 。 笔 者 也 将 这 部 分 高 频率 使 用 的 方法 进 


行 了 向 单 封 雄 。 获 取 控 件 的 状态 的 步 又 比较 商 单 ， 首 移 找 到 对 应 的 控 
件 ， 然 后 查找 控件 的 状态 。 笔 者 封 痛 的 方法 包括 
checkElementIsShown、checkElementShownInParentElement、 
checkElementIsSelected、checkElementIsChecked 、 
checkElementIsEnabled 等 ， 这 些 方法 返回 值 为 True 或 False， 在 if 语句 或 
者 Assert 中 使 用 起 来 比较 方便 ， 以 下 代码 是 checkElementIsEnabled 的 示 
例 。 


def checkElementIsEnabled(self, elementInfo): 
element = self.findElement(elementInfo) 
return element.get_attribute("enabled") 


以 上 为 部 分 和 常 用 的 Appium 接 口 的 封装 方法 ， 其 他 一 些 方法 就 不 在 
这 里 资 述 了 ， 详 情 可 以 参考 TMQ 官 网 下 载 的 第 6 草 中 的 UIHelper 的 源 代 
码 。 


6.3.2 ”测试 脚本 设计 思想 


在 开始 讲解 本 部 分 内 容 前 ， 我 们 先 思 考 一 个 问题 。 如 采 一 个 月 发 
布 一 个 版 本 ， 在 上 线 前 都 需要 回归 茶 功 能 ， 如 有 果实 现 这 个 功能 的 目 动 
化 只 需要 一 天 ， 那 是 否 应 该 对 这 个 功能 实现 目 动 化 测试 ? 这 个 问题 没 
有 绝对 的 答案 ， 与 实际 项 目的 具体 情况 有 很 大 的 关系 。 其 实 笔 者 硕 望 
读者 在 看 到 这 里 时 ， 心 里 对 目 动 化 测试 有 一 个 正确 的 概念 :“ 目 动 化 测 
试 的 根本 目的 是 提高 效率 和 降低 成 本 。” 在 实施 目 动 化 测试 之 前 ,我们 
需要 进行 如 下 思考 : 


首先 ， 项 目 古 否 真 的 需要 目 动 化 测试 ， 投 入 产 出 比如 何 ? 


其 次 ， 什 么 目 动 化 方法 更 适合 ? 


在 实际 项 目 中 ， 很 多 测试 人 员 过 多 地 考虑 第 三 个 问题 ， 也 会 做 一 
些 关 于 第 二 个 问题 的 调查 ， 但 往往 缺乏 对 第 一 个 问题 的 思考 。 在 此 建 
议 读 者 从 目 己 项 目的 角度 出 发 ,慎重 思考 目 动 化 测试 的 投入 和 收益 ， 
选择 适合 项 目的 方法 ， 使 投入 产 出 比 最 大 化 。 


在 这 里 ， 我 们 不 过 多 地 讨论 是 否 需 要 目 动 化 。 在 已 经 确定 目 动 化 
测试 可 以 市 来 收益 的 情况 下 ， 则 需要 选择 测试 方案 ， 尽 量 让 开发 成 本 


和 维护 成 本 降低 一 些 。 如 采 考 虑 选择 Appium 作 为 目 动 化 测试 工具 ， 建 
议 读者 考虑 以 下 几 个 方面 : 


第 一 ， 被 测试 程序 主要 变化 的 地 方 是 什么 ， 是 否 适 合用 UI 目 动 化 
测试 。 如 果 应 用 程序 UI 变 化 概率 比较 小 ， 代 码 变动 主要 是 下 层 逻 辑 ， 
这 样 的 程序 比较 适合 做 UI 自动 化 测试 。 如 果 UI 变 化 大 ， 那 么 UI 自动 化 
脚本 维护 成 本 殊 会 很 大 ， 目 动 化 测试 投入 产 出 比 不 高 。 


第 二 ， 被 测试 的 程序 古 什 么 类 型 的 应 用 。 比 如 游戏 类 的 测试 ， 可 
能 很 多 的 画面 都 是 通过 OpenGL 直 接洽 染 的 ，Appium 无 法 找到 OpenGL 
直接 泻 染 出 来 的 画面 里 的 元 素 ， 而 且 从 UI 上 去 验证 游戏 画面 非常 困 
难 ， 在 这 种 情况 ， 如 有 宁 通 过 UI 实 施 目 动 化 测试 可 能 需要 大 量 的 后 期 人 


工 检查 。 


第 三 ， 目 动 化 测试 的 目标 是 什么 ， 是 否 对 测试 的 运行 时 间 有 要 
求 。 如 果 目 动 化 的 目标 是 快速 地 回归 ， 要 求 测 试 脚本 短 时 间 内 完成 大 
批 脚 本 的 运行 的 话 ， 此 时 可 能 不 适合 用 Appium。 因为 Appium 是 UI 日 
动 化 测试 ，UI 目 动 化 测试 的 运行 同一 条 测试 的 时 间 比 人 工 执 行 的 时 间 
要 长 ， 所 以 很 难 在 短 时 间 内 运行 大 批量 的 测试 。 但 如 采 没 有 时 间 要 
求 ， 比 如 每 天 晚上 定时 运行 的 冒 烟 测 试 ， 则 不 用 考虑 时 间 歼 率 。 


第 四 ， 目 动 化 测试 是 否 要 脱 机 执行 。 比 如 性 能 测试 中 的 耗 电量 测 
试 ， 必 须 断 开 与 电脑 的 连接 ， 人 否则 USB 线 会 给 手机 充电 。 由 于 Appium 


是 必须 与 电脑 连接 的 ， 以 上 的 场景 就 不 能 通过 Appium 来 实施 目 动 化 ， 
可 以 考虑 选择 UIAutomator。 


第 五 ， 如 打 选 择 Appium 来 实施 目 动 化 测试 ， 什 么 语言 比较 合适 。 
可 以 从 当前 团队 成 员 的 能 力 考 虑 ， 选 择 学 习 成 本 和 实施 成 本 较 低 的 语 


人 
吾 O 


测试 方案 确定 下 来 后 ， 束 需要 考虑 如 何 实施 了 。 有 过 目 动 化 测试 
开发 经 验 的 读者 应 该 知道 ， 目 动 化 测试 的 脚本 开发 其 实 不 难 ， 但 测试 
脚本 的 维护 却 是 比较 困难 的 。 测 试 脚本 设计 的 思想 是 尽 量 地 提高 测试 
脚本 的 可 重用 性 和 稳定 性 ， 降 低 脚 本 的 维护 成 本 ， 提 高 收益 。 


6.3.3 Appium 在 腾讯 地 图 中 的 测试 实践 


腾讯 地 图 项 目 在 初期 的 时 候 ， 由 于 功能 较 少 ， 测 试 人 员 较 容易 发 
现 开发 check in 代 码 引 入 的 回归 问题 。 但 是 随 着 项 目 功能 的 增多 ， 测 试 
人 员 应 对 新 需求 测试 压力 越 来 越 大 ， 对 老 功能 的 回归 测试 的 频率 从 最 
开始 的 一 周 两 次 ， 变 成 每 个 月 只 在 发 版 前 才 进 行 几 轮 ， 项 目 组 也 开始 
挑战 测试 团队 发 现 Bug 晚 的 问题 。 基 于 这 样 的 育 景 ， 测 斌 人员 开 始 思考 
征 人 否 可 以 通过 目 动 化 方式 来 尽早 发 现 这 些 问 题 ， 特 别 羡 老 功 能 的 回归 
测试 。 


腾讯 公司 有 一 个 叫 作 RDM 的 集成 系统 ， 该 系统 可 以 定期 对 最 新 的 
代码 进行 编译 ， 项 目 成 员 可 以 获取 每 天 最 新 的 版 本 (Daily Build) 。 测 
试 团 队 经 过 与 开发 人 员 的 沟通 ， 最 终 决 定 采 用 基于 RDM 系 统 的 Daily 
Build 实 施 冒 烟 测 试 。 


有 了 这 样 的 想法 之 后 ， 我 们 束 开 始 调 人 研 测试 方案 。 百 先 我 们 调 人 研 
了 十 通过 接口 去 实施 目 动 化 ， 还 古 从 UI 上 去 实施 目 动 化 。 在 调研 过 程 
中 ， 我 们 发 现 通 过 接口 的 方式 去 实施 目 动 化 的 优 和 缺点， 优点 是 测 试 运 
行 比较 快 ， 可 以 很 快 地 进行 回归 ; 缺点 是 测试 代码 对 开发 代码 有 较 大 
的 依赖 ， 往 往 是 开发 的 代码 发 生 了 改变 ， 测 试 代码 没 能 同步 修改 ， 等 
下 一 次 编译 运行 时 发 现 测试 代码 又 编译 不 通过 。 测 试用 例 少 的 时 候 还 
好 ， 随 着 用 例 的 扩充 ， 测 试 人 员 已 经 疲 于 维 护 测 试 代码 了 。 之 后 我 们 


分 析 了 地 图 项 目 组 的 情况 ， 发 现 从 地 图 4.0 版 本 以 来 ，UI 几 乎 没有 大 的 
改动 ， 多 数 的 改动 部 是 发 生 在 逻辑 层 的 ， 因 此 最 终 我 们 决定 从 UI 上 实 
施 目 动 化 。 当然 从 UI 上 实施 目 动 化 测试 也 存在 一 定 的 问题 ， 比 如 运行 
效率 较 低 ， 此 外 地 图 一 般 都 是 通过 OpenGL 和 直接 绘制 出 来 的 图 片 ， 无 法 
目 动 化 验证 ， 等 等 。 对 于 效率 低 的 问题 ， 我 们 采用 晚上 运行 的 方案 ， 
即 让 RDM 系 统 在 晚上 编译 ， 冒 烟 测 试 在 晚上 运行 ， 第 二 天 再 看 测试 结 
条 ， 这 样 即 使 运行 效率 低 点 儿 ， 也 不 占用 人 的 时 间 ， 还 是 可 以 接受 
的 ;对 于 我 证 的 问题 我 们 最 终 采 用 折 中 的 方案 ， 束 目 动 化 测试 能 儿 
证 多 少 就 验证 多 少 ， 如 果 需 要 在 地 图 上 进行 验证 ， 那 束 让 外 包 人 员 人 
工 验 证 ， 一 个 熟练 的 外 包 人 员 看 结果 只 需要 10 分 钟 束 能 完成 了 。 


当主 思路 确定 后 就 开始 测试 方法 的 选择 ， 我 们 考察 了 
UIAutomator、Robotium 和 Appium 等 工具 ， 这 三 个 工具 基本 上 都 能 满足 
地 图 项 目的 需求 ， 但 最 终 项 目 组 选择 了 使 用 Appium。 选 择 Appium 除 了 
上 面 的 思考 以 外 ， 还 有 以 下 一 些 考 虑 : 


-自动 化 工具 简单 易 用 ， 最 好 是 学 习 成 本 不 太 高 ， 便 于 调试 。 以 上 
三 个 工具 基本 上 都 符合 ， 但 笔者 觉得 还 是 Appium 最 简单 ， 大 部 人 员 都 


能 很 快 学 会 。 


:该 测试 不 仅 要 用 于 对 Daily Build 的 测试 ， 还 要 用 于 发 布 前 的 测 
试 ， 测 试 方案 最 好 不 需要 对 测试 包 进行 修改 。 其 中 Robotium 需 要 对 测 
试 包 做 一 点 儿 修改 ， 在 这 里 不 太 符合 。 


:由 于 地 图 组 分 为 Android 和 iOS 的 冒 烟 测试 都 是 一 片 空白 的 ， 需 要 
从 头 建立 ， 最 好 有 一 种 方案 可 以 让 两 个 系统 共用 一 部 分 脚本 ， 降 低 开 
发 成 本 ， 且 统一 输出 格式 ， 以 便于 统一 展示 。 关 于 这 一 点 ， 只 有 
Appium 满 足 条 件 。 


Appium 文 持 多 种 开发 语言 ， 但 羡 实 施 目 动 化 时 ， 我 们 选择 Python 
作为 开发 语言 ， 主 要 是 项 目 组 会 Python 的 人 挺 多 ， 学 习 成 本 低 ， 而 且 
Python 是 解析 执行 的 语言 ， 修 改 后 不 需要 编译 立刻 可 以 运行 ， 调 试 也 较 
为 方便 。 


由 于 UI 目 动 化 的 执行 效率 实在 不 快 ， 我 们 并 不 期 望 冒 烟 测 试 可 以 
巷 代 大 部 分 的 回归 测试 工作 ， 而 且 考 虑 到 脚本 覆盖 过 细 ， 场 景 后 期 维 
护 成 本 会 很 高 ， 因 此 我 们 的 冒 烟 测 试用 例 只 窗 盖 了 各 功能 主要 的 路 


人 


基于 Appium 的 框架 ， 地 图 测试 用 Python 实现 了 一 个 通用 的 测试 模 
块 ， 可 以 在 Android 和 iOS 上 共用 。 该 测试 模块 的 类 图 如 图 6-12 所 示 。 


测试 脚本 的 基 类 TestBase 继 承 于 Python 的 unittest.TestCase， 在 
TestBase 中 将 初始 化 UiHelper， 以 及 测试 日 志 记 录 的 类 Logger。 


unittest.TestCase 


findElement() 
findElements') 


uiHelper : UiHelper 
logger :Logger 

setFailf) 

setFail\ WithException() 
setPass() 


setManual() 


_logPath : String 
logDebua() 
log() 


swipe() 
waitForElement() 


CommonMethod 


commonFuntionO 


图 6-12 ”地 图 冒 烟 测 试 模块 的 类 图 


test 1 sampleCase1f) 
test_2_sampleCase2() 


UiHelper 是 唯一 与 Appium 服 务 絮 进行 通信 的 类 ， 所 有 与 Appium 服 
务 絮 相关 的 操作 都 统一 使 用 该 类 。 


Logger 和 是 一 个 单 例 的 对 象 ， 用 于 记录 格式 化 的 测试 日 志 ， 所 有 测 
试 运行 中 需要 输出 的 日 志 都 将 用 这 个 类 的 方法 来 记录 。 


测试 脚本 分 为 两 部 分 ， 它 们 都 继承 于 TestBase。 一 部 分 是 测试 用 例 
(TestCases) ， 它 是 具体 的 测试 场景 ， 另 外 一 部 分 是 在 多 个 用 例 中 都 
使 用 到 的 公共 方法 库 (CommonMethod) 。 


1. 可 重用 性 


提高 测试 脚本 的 可 重用 性 可 以 一 定 程度 上 降低 开发 和 维护 成 本 。 
在 地 图 项 目 中 ， 脚 本 可 重用 性 体现 在 测试 代码 重用 和 测试 脚本 模板 重 
用 两 方面 。 


测试 代码 的 可 重用 主要 是 公共 过 程 的 提取 。 有 目 动 化 测试 经 验 的 
读者 应 该 知道 ， 测 试 工 具 一 般 会 提供 setUp 和 tearDown 两 个 方法 ，setUp 
方法 会 在 用 例 方 法 运行 前 被 执行 ，tearDown 方 法 会 在 用 例 方 法 运行 后 
被 执行 。Python 的 unit.TestCase 类 也 提供 同样 的 方法 。 因 此 将 Appium 和 连 
接 的 建立 和 网 络 初始 化 放 到 这 个 方法 中 ， 就 不 用 再 在 每 个 脚本 中 重复 
开发 ， 如 代码 清单 6-13 所 示 。 在 地 图 项 目 中 ， 测 试 场景 中 常用 的 方法 也 
被 提取 出 来 ， 形 成 公共 方法 库 ， 测 试 脚本 可 以 由 多 个 公共 方法 组 合 形 
成 用 例 。 


代码 清单 6-13” 基 类 中 公共 方法 示例 


def setUp(self): 
try: 


self.uiHelper.initDriver() 
self.uiHelper.enablewifiOnly() 

except: 
self.uiHelper .quitDriver() 
exstr = traceback.format_exc() 
self.logger.1log(exstr) 
self.logger.1log("Setup Failed") 
self.fail("") 

def tearDown(self): 

try: 
self.uiHelper .quitDriver() 
sleep(5) 

except: 
pass 


测试 脚本 模板 重用 是 指 抽取 脚本 通用 部 分 ， 开 成 公共 模板 ， 便 于 
后 期 快速 开发 脚本 ， 如 代码 清单 6-14 所 示 ， 并 且 这 些 模板 格式 较为 固 

能 通过 脚本 直接 生成 。 这 样 测试 人 员 束 可 以 重点 关注 用 例 的 开 
缩短 测试 脚本 的 开发 时 间 。 


肖 


代码 清单 6-14 测试 脚本 模板 的 示例 


def test_1 sample(self): 
caseName = Self.get_current_function_name( ) 
decription = "the description of this case" 
try: 
self.markCaseStart(self.currentFileName, self., class ._name , 
caseName, decription) 
CommonMethod.dismissUserGuideIfExist() 
CommonMethod.dismissDialogIfExist() 
#Auto generated code 
Self.SaveScreenshot(caseName + "_1.png") 
self.setPpass() 
except Exception as e: 
self.setFailwithExceptionInfo(caseName) 


Appium 的 目 动 化 测试 在 运行 过 程 中 过 到 的 稳定 性 问题 主要 有 以 下 
儿 种 情况 : 

(1) 用 例 运 行 时 受 前 一 个 用 例 运 行 的 影响 ， 程 序 状态 不 正确 导致 
测 弃 脚 本 运行 铺 误 。 最 章 过 到 的 是 前 一 个 脚本 异 间 退出 ，Session 还 没 
有 正 稼 结束， 可 能 导致 后 面 用 例 在 建立 Session 时 失败 。 


(2) 脚本 包含 多 个 用 例 ， 如 果 用 例 查找 控件 失败 ， 则 会 抛 出 异 
常 ， 导 致 整个 脚本 都 退出 了 ， 后 续 用 例 将 不 能 正常 运行 。 例 如 ， 在 刚 


开始 的 时 候 脚本 没有 做 任何 异 间 捕获 ， 当 用 例 出 现 异 利 时 直接 残 中 断 
了 该 脚本 的 运行 ， 后 面 的 用 例 束 不 可 能 再 被 运行 了 。 


(3) 在 程序 运行 过 程 中 ， 未 预期 的 消息 框 弹出 ， 导 致 测试 脚本 运 
行 出 错 。 例 如 我 们 比较 容易 遇 到 启动 地 图 时 提示 用 户 需要 开启 Wi-Fi 或 
者 GPS 的 情况 。 


针对 第 一 种 情况 ， 笔 者 的 解决 方法 如 下 : 
首 完 ， 用 例 之 间 不 相互 类 合 ， 每 一 个 用 例 都 是 一 个 可 独立 运行 的 
方法 ， 不 依赖 任何 其 他 的 用 例 。 


其 次 ， 每 个 测试 脚本 都 从 程序 局 动 状态 开始 运行 ， 因 为 中 间 状 态 
不 能 确保 正确 。 如 果 用 例会 对 程序 有 一 些 设置 ， 那 么 每 个 用 例 结束 后 
将 设置 状态 恢复 到 初始 状态 。 


最 后 ， 在 setUp 和 tearDown 方 法 中 初始 化 与 断 开 Appium 的 连接 ， 保 


证 Appium 服 务 属 是 一 个 清 党 的 环境 。 


针对 第 二 种 情况 ， 笔 者 的 解决 方法 是 将 每 一 个 测试 脚本 的 代码 部 
包含 在 try-except 中 ， 保 证 测试 脚本 中 的 异常 者 能 个 每 个 用 例 捕获 ， 即 
使 当前 用 例 失 败 了 ， 后 续 用 例 也 可 以 正常 运行 。 


对 于 第 三 种 情况 笔者 也 没有 很 好 的 方法 ， 只 能 尽量 保证 测试 环境 
的 清洁 ， 在 setUp 方 法 中 就 将 Wi-Fi 和 GPS 打 开 ， 并 在 启动 地 图 后 稍 作 等 


待 ， 然 后 判断 是 否 存在 Dialog， 有 则 清除 掉 ， 降 低 这 类 问题 出 现 的 概 
率 。 


3. 可 维护 性 


UI 目 动 化 测试 脚本 的 维护 主要 发 生 在 UI 变更 时 。UI 的 变更 主要 有 
两 个 方面 : 一 是 功能 的 流程 发 生变 化 ， 二 是 控件 的 信息 (如 ID) 发 生 


Es 


测试 过 程 提 取 为 公共 方法 的 作用 之 一 融和 是 降低 过 程 变化 时 的 维护 
成 本 。 当 流程 发 生变 化 时 ， 只 需要 改动 公共 方法 ， 而 不 用 对 每 个 脚本 
进行 维护 。 最 常见 的 情况 就 是 每 个 用 例 都 需要 处 理 新 功能 引导 页 ， 而 
且 每 个 版 本 发 布 时 新 功能 引导 页 都 可 能 会 变化 。 如 果 将 该 方法 提取 出 
来 ， 则 当 新 功能 引导 变化 时 ， 只 需要 维护 该 方法 即 可 。 


而 针对 控件 信息 发 生变 化 的 情况 ， 笔 着 采用 的 方法 十 将 控件 的 信 
息 集 中 维护 到 一 个 常量 文件 中 (图 6-13) ， 当 控件 信息 发 生变 化 时 ， 只 
需要 维护 该 文件 即 可 ， 不 用 修改 用 例 脚本 。 


询 elementinfo.py x 


各 图 血 都 共有 的 控件 


ponies: id/1ocate” 


Sh hh I Evy 
% ' 


# 科 有 凡 酒 小 玉 宽 


ZOOM OUT_BUTTON = "cmeemeninee:id/Zzoom Out” 


eid/zoom in” 


图 6-13 ”控件 信息 通过 文件 独立 管理 示例 


男 外 ， 天 于 用 例 的 管理 ， 笔 者 主要 是 通过 物理 文件 来 进行 的 ， 比 
如 冒 烟 测试 的 用 例会 存放 在 一 个 目录 下 ， 而 功能 测试 的 脚本 叉 存 放 在 
另外 的 目 孙 中 。 而 目 孙 中 的 测试 脚本 又 按 功能 模块 分 为 不 同 的 脚本 文 
件 ， 在 每 个 脚本 文件 中 有 一 个 类 ， 该 类 包含 多 个 测试 用 例 。 而 我 们 的 
脚本 运行 工具 是 Nosetests， 该 工具 可 以 通过 命令 的 参数 来 指定 运行 的 泡 


围 。 


@ 提示 Python 安 闭 成 功 后 ，Nosetests 可 以 通过 以 下 方式 来 安 


命令 行 下 运行 : pip install nose。 


下 
3 


Nosetests 的 运行 方式 有 : 


运行 指定 路 径 下 所 有 用 例 ， 如 nosetests-s D: \map\bvt\; 


运行 指定 文件 内 的 所 有 用 例 ， 如 nosetests-s D: 


\map\bvt\test_map_bvt.py:; 


运行 指定 类 下 所 有 用 例 ， 如 nosetests-s D: 
\map\bvt\test_map_bvt.py: MapTest_BVT:; 
运行 指定 的 用 例 ， 如 nosetests-s D: \map\bvt\test_map_bvt.py: 


MapTest_BVT.test_02_openTraffic_BVT 。 
除了 运行 工具 以 外 ， 地 图 测试 组 还 有 一 个 叫 作 八 爪 鱼 的 目 动 化 管 
理 平台 辅助 进行 用 例 管理 。 该 平台 用 例 管 理 页 面 如 图 6-14 所 示 ， 在 该 页 
面 我 们 可 以 任意 选择 需要 运行 的 用 例 ， 使 用 例 管理 更 加 方便 。 
在 腾讯 地 图 项 目 中 ， 目 动 化 脚本 都 通过 SVN 部 署 到 一 台 自 动 化 服 
通过 八 爪 鱼 平台 的 任务 管理 定时 将 任务 发 布 到 自动 化 机 器 上 
去 运行 ， 并 将 目 动 化 结果 上 传 到 八 爪 鱼 目 动 化 平台 ， 展 示 结 采 如 图 6-15 


务 器 上 ， 


的 
在 腾讯 地 图 的 冒 烟 测 试 实施 之 后 ， 基 本 上 较为 闫 重 的 回归 问题 虱 
可 以 在 出 现 一 天 之 内 被 发 现 ， 甚 至 后 来 开发 人 员 已 经 不 满足 于 一 天 的 
延迟 时 间 ， 因 此 我 们 又 将 冒 烟 测 试 任务 时 间 缩 短 为 每 4 个 小 时 运行 一 


次 ， 更 缩短 了 回归 问题 的 发 现 周 期 。 


全 部 脚本 ， 创建 任务 集 


国 bvtSetup.py 
国 test_map_bvt.py 

看 ”编号 ”用例 名 称 
test_01 voice_BVT 
test 02_openTraffic_BVT 
test_03_satelliteMap_BVT 
test 04 _ switch3dMode_BVT 


国 国 | 国 | 国 | 国 


test 05_measureDistance_BVT 


test_06_snapshot_BVT 


国 


test_07_switchCity_BVT 
test 08 zoom_BVT 


国 
© BY ~ ES vl PR WW MP 


国 图 


test_09_openStreeViewRoad_BVT 


中 由 由 由 由 由 由 由 由 由 


国 10 test 10 swipeMapAndPressLocation_BVT 


国 test_poi_search_bvt.py 
国 test_offline_mode_search_bvt.py 


I +art nm rmnrrh hort ms 


图 6-14 ” 八 爪 鱼 平台 用 例 管理 页 面 


会 ”用 例 管理 。 任务 管理 。” 功能 测试 报告 ”性 能 测试 报告 ”帮助 


1 加 用例 结 时 
. 多 DiscoveryTest_BVT 
. 人 @ test_ 1 Circum _Search_BVT 
加 test_ 3 Launch ElecDog_BVT 
: @@ test_ 5 Launch ILife_BVT 


和 色 MapTest_BVT 


test_01_ voice_BVT 
test 02 openTraffic_BVT 
test_03_satelliteMap_BVT 
test_04 switch3dMode_BVT 
test_ 05_measureDistance_BVI 
test_06_snapshot_BVT 
test_07_switchCity_BVT 
test_08 zoom_BVT 
test_09_openStreeViewRoad_ 
| test_10_swipeMapAndPressLc 
i 名 MeTest_BVT 
| 人 @ test_1 login_BVT 


! test 01 Voice _BVT 【返回 上 级 列表 ] 


执行 结果 : Manual 书 

结果 评论 : 

用 例 描述 : 测试 进入 语音 搜索 功能 ,点 击 录音 按钮 
所 屋 用 例 集 : MapTest_BVT 


+##+##x#x test_O1 VOiCce_BVT 

2015-12-25 13:06:17 点 击 语音 搜索 

2015-12-25 13:06:24 进入 语音 输入 界面 

2015-12-25 13:06:27 Capture screen: test 01 voice_BVT_1.png 
2015-12-25 13:06:27 File Path: j:\mosaresult\test_01 voice_BVT_1.png 
2015-12-25 13:06:29 点 击 录音 按钮 

2015-12-25 13:06:31 Capture screen: test_01 voice_BVT 2.png 
2015-12-25 13:06:31 File Path: j:\mosaresult\test_01 voice_BVT_2.png 
2015-12-25 13:06:35 点 击 取 消 返 回 地 图 

**#### Result MANUAL 


2015-12-25 13:06:36 MapTestBase::tearDown 
2015-12-25 13:06:49 TestBase::tearDown 


图 6-15 “腾讯 地 图 冒 烟 测试 展示 结 


6.3.4 ”Hybrid App 的 测试 方法 


Hybrid App 是 移动 混合 应 用 程序 ， 即 在 移动 应 用 程序 中 航 入 了 
Webview， 通 过 Webview 访 问 网 页 。 移 动 应 用 和 Webview 分 别 属于 两 个 
不 同 的 上 下 文 (Context) ， 移 动 应 用 默认 的 Context 
为 “NATIVE_APP”， 而 Webview 默 认 的 Context 为 “WEBVIEW_{ 被 测 进 
程 名 称 }”。Appium 在 测试 应 用 程序 时 ， 默 认 会 使 用 NATIVE_APP 的 
Context; 当 测 试 Webview 中 的 网 页 内 容 时 ， 需 要 切换 到 Webview 的 
Context 下 ; 同样 如 当前 正在 测试 Webview， 此 时 若 需 要 回 到 移动 应 
用 ，Context 需 要 切换 到 NATIVE_APP 下 。 


获取 当前 手机 上 正在 显示 画面 的 Context 可 以 使 用 WebDriver 提 供 的 
contexts 方 法 。 调 用 该 方法 时 如 果 正 在 显示 的 画面 包含 Webview， 从 
Appium 的 日 志 中 可 以 看 到 可 用 的 Context 包 含 “WEBVIEW”， 如 下 面 的 


日 志 所 示 。 


info: [debug] Getting a list of available webviews 

info: [debug] Available contexts: 

info: [debug] ["WEBVIEW_ com.xxxxx.map"] 

info: [debug] Available contexts: NATIVE_APP,WEBVIEW_ com.xxxxx.map 


如 果 要 切换 到 Webview 的 Context 下 ， 请 调用 WebDriver 中 的 switch- 
to.context 方 法 。 在 UiHelper 中 调用 的 代码 如 下 面 的 代码 所 示 ， 其 中 参数 


的 contextName 为 上 面 提 到 的 “Available contexts” 中 的 和 名称。 


def switchContext(self, contextName): 
self._driver.switch_ to.context(contextName) 


在 测试 Hybrid App 时 可 能 会 遇 到 一 些 单 见 问 题 ， 以 下 十 笔者 遇 到 的 
问题 和 这 些 问题 的 解决 方法 。 


1. 如 何 获 取 Webview 中 的 页 面 信息 


当 需 要 操作 和 验证 Webview 中 的 控件 时 ， 需 要 找到 这 些 控 件 的 信 
息 ， 笔 者 采用 的 方法 是 通过 Chrome 的 DevTools 来 获取 ， 该 工具 可 能 
要 Webview 打 开 Debug 开 大。 


@ 提示 ”笔者 在 测试 腾讯 地 图 时 ， 使 用 的 是 Android 4.4.4 的 手 
机 ， 默 认可 以 通过 Chrome 的 DevTools 查 看 Webview 的 内 容 。 如 果 读 者 发 
现 DevTools 不 能 Debug Webview 时 ， 可 以 尝试 在 被 测 程序 的 WebView 中 
加 上 代码 把 Debug 打 开 ， 代 码 如 下 : 


If (Build.VERSION.SDK_INT >= Bulild.VERSION_CODES ,KITKAT) { 
WebView.setwebContentsDebuggingEnabled(true); 


} 


先 将 测试 手机 设置 -开发 者 选项 -Android 调 试 开关 打开 ， 再 将 手机 
与 电脑 连 授 上 。 然 后 打开 电脑 上 的 Chrome 浏 唤 絮 ， 在 地 址 柱 输 
入 “chrome: //inspect/#devices”， 按 回 车 键 。 此 时 在 浏览 器 上 应 该 束 可 


以 看 到 如 图 6-16 所 示 的 画面 。 如 果 此 时 测试 手机 画面 上 有 可 识别 的 
Webview， 在 该 画面 上 就 会 显示 网 页 的 链接 ， 点 击 下 面 的 inspect 画 面 ， 
在 新 的 DevITools 中 查看 Webview 的 内 容 (图 6-17 中 左 图 ) ， 选 择 
DevTools 的 某 个 Element 在 手机 上 会 同步 选中 对 应 的 Element (图 6-17 中 
右 图 ) ， 右 键 选中 DevTools 中 的 Element 还 可 以 复制 CSS 和 XPath 。 
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DevTools Devices 


Devices HDiscover US8 devices | Port forwarding... 


Nexus 5 #052A8D630A670A6A 
WebView in (33.0.0.0) 
EULA.html f 


at {96, 37) size e 888 x c 1536 
iNnspect 


图 6-16 Chrome DevTools 连 接 画 面 
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图 6-17 DevTools 上 inspect 网 页 内 容 


2. 不 能 获取 Webview 的 Context 


在 测试 Hybrid App 时 可 能 会 过 到 Webview 的 Context 不 能 正确 获取 的 
情况 ， 从 Appium 日 志 中 可 以 看 到 Context 只 有 “NATIVE_APP”， 而 没有 
Webview 有 的 Context， 和 情况 如 下 面 的 日 志 所 示 。 


info: [debug] Getting a list of available webviews 

info: [debug] executing cmd: C:\android\platform-tools\adb.exe -s 052abd630a670a6a 
shell "cat /proc/net/unix" 

info: [debug] Available contexts: 

info: [debug] [] 

info: [debug] Available contexts: NATIVE_APP 


出 现 这 种 情况 的 原因 可 能 有 以 下 两 种 : 


首先 ，Desired Capabilities 中 automationName 使 用 Appium， 但 是 测 
试 手机 不 是 Android 4.4 以 上 的 版 本 。 由 于 4.4 以 下 版 本 的 Webview 没 有 使 
用 Chrome 内 核 ， 只 有 在 Selendroid 模 式 中 才 支 持 4.4 以 下 的 内 核 。 


其 次 ， 程 序 中 使 用 的 Webview 不 是 Chrome 内 核 。 由 于 Appium 只 文 
持 Chrome 内 核 ， 如 果 Webview 使 用 的 是 其 他 内 核 ，Appium 残 不 能 获取 
该 WebView 的 Context。 例 如 ， 腾 讯 地 图 某 些 页 面 就 使 用 了 QQ 浏览 器 的 
X5 内 核 ， 导 人 致 无 法 测试 网 页 内 容 。 


6.3.5 Appium 脚 本 第 见 问 题 及 处 理 方法 


本 小 节 我 们 来 看 一 下 Appium 脚 本 常见 问题 及 处 理 方法 。 


1. 运 行 时 过 到 异常 “A new session could not be created” 


在 测试 过 程 中 往往 会 遇 到 “A new session could not be created” 的 问 

， 造 成 该 问题 的 原因 大 多 数 是 测试 异常 退出 导致 Appium 服 务 絮 上 的 
Session 没 有 正确 结束 ;， 男 外 还 可 能 是 被 测 的 应 用 程序 正 处 在 前 人 台 ， 导 
致 脚本 不 能 正确 地 建立 Session。 


笔者 解决 这 类 问题 的 方法 主要 有 以 下 三 种 : 


-在 测试 基 类 的 setUp 方 法 中 ， 调 用 UiHelper 的 init 方 法 之 前 用 ADB 
命令 强制 关闭 被 测 应 用 一 次 ， 保 证 与 Appium 连 接 前 被 测 应 用 不 是 在 前 


运行 状态 。 


ID 


.在 Appium 的 服务 恬 启 动 时 加 上 “--session-override”， 测 试 脚本 在 
运行 过 程 中 同样 的 Session 会 履 盖 之 前 的 Session， 人 确保 Session 可 以 正确 


只 


.在 测试 基 类 的 tearDown 方 法 中 ， 关 闭 Appium 的 Session， 每 个 用 例 
结束 时 目 动 关闭 Session， 下 一 个 用 例 开始 时 Appium 服 务 器 的 环境 就 是 


清洁 的 环境 。 


2. 在 一 人 台电 脑 上 用 Appium 测 试 多 个 手机 


一 个 Appium 服 务 磺 只 能 连接 一 个 测试 设备 进行 测试 ， 如 果 要 在 一 
台电 脑 上 同时 测试 多 个 设备 ， 解 决 方法 是 在 电脑 上 局 动 多 个 Appium 服 
务 絮 ， 每 个 Appium 服 务 絮 分 别 连接 不 同 的 测试 设备 。 由 于 Appium 服 
务 器 默认 监听 4723 端 口 ， 同 时 Appium 服 务 器 与 手机 的 BootStrap.jar 通 
信和 默认 使 用 4724 端 口 ，ChromeDriver 默 认 使 用 9515 端 口 。 如 不 修改 局 
动 命令 ， 再 次 局 动 Appium 时 会 提示 端口 已 经 被 占用 ， 因 此 需要 在 启动 
命令 中 将 监听 的 端口 改 为 未 使 用 的 端口 ， 端 口号 为 0~65535 。 


他 提示 。 Appiam 监 听 端 口 和 Bootstrap 端 口 是 必 须 指定 的 ， 如 果 
仅 是 测试 移动 Native 应 用 程序 可 以 不 指定 ChromeDriver 端 口 。 


除了 测试 服务 闫 监听 的 端口 需要 更 改 以 外 ， 还 需要 分 别 为 每 个 测 


试 服 务 硕 指定 连接 的 测试 设备 UID。 
修改 以 上 信息 可 以 在 Appium 服 务 右 启动 命令 中 加 上 以 下 参数 : 
-p: 服务 右 端 口 
-bp: Bootstrap 端 口 


.-U: 连接 设备 的 UID 


.--Chromedriver-port: ChromeDriver 的 端口 


假设 与 电脑 连接 的 设备 UID 分 别 为 1234 和 2345。 首先 局 动 一 个 命 
令 行 窗口 ， 使 用 默认 的 端口 启动 第 一 个 服务 器 连接 到 1234 的 手机 ， 命 
令 如 下 面 的 代码 所 示 。 


node appium.js --session-override - 


p 4723 - 


bp 4724 --chromedriver-port 9515 - 


U 1234 


再 局 动 男 外 一 个 命令 行 窗口 ， 用 非 默 认 的 端口 局 动 第 二 个 服务 器 


连接 到 2345 的 手机 ， 命 令 如 下 面 的 代码 所 示 。 

node appium.js --session-override - 
p 4725 - 
bp 4726 --chromedriver-port 9516 - 


U 2345 


测试 服务 器 已 经 启动 了 ， 此 时 测试 脚本 的 配置 文件 需要 将 连接 的 
端口 修改 成 对 应 服务 器 的 端口 (图 6-18) 


， 测 试 脚 本 使 用 该 配置 文件 
忠 能 连接 到 第 二 个 测试 服务 右 了 ， 并 在 第 二 个 手机 上 进行 测试 。 


DTIa 
platformVersion=4.4.4 
udid=052abd630a670a6a 
appPackage=com.tencent .map 


appActivity=.WelcomeActivity 
unicodeKeyboard=true 
newCommandTimeout=150 
remoteHost=http://127.0.0.1:4725/wQ/hub 


6-18 与 第 二 个 服务 需 连 接 的 配置 文件 
3. 通 过 findElementByUIAutomator 方 法 查找 列表 项 


在 测试 过 程 中 ， 可 能 遇 到 需要 查找 列表 中 的 某 个 列表 项 的 问题 ， 
但 是 该 列表 项 具体 的 位 置 未 知 ， 可 能 显示 在 屏幕 上 ， 也 可 能 需要 滑动 
列表 才能 显示 出 来 。 例 如 ， 如 图 6-19 所 示 ， 离 线 地 图 数据 的 城市 列表 
包含 全 国 300 多 个 城市 的 入 口 ， 该 列表 非常 长 。 如 果 要 找到 哈尔滨 市 ， 
则 测试 脚本 需要 癌 下 滑动 列表 。 在 不 同 屏幕 分 辨 率 的 于 机 上 ， 请 动 屏 
幕 的 次 数 可 能 是 不 一 样 的 ， 因 此 测试 脚本 中 不 能 写 固 定 的 滑动 次 数 ， 
而 应 该 使 用 一 种 更 加 灵活 的 方式 。 


图 6-19 ”腾讯 地 图 离线 地 图 列表 


经 过 笔者 的 一 些 党 试 ， 发 现 通 过 WebDriver 提 供 的 
find_element_by_android_uiautomator 方 法 ， 可 以 比较 方便 地 处理 这 种 
情况 。 如 下 面 的 代码 所 示 ， 方 法 中 调用 了 
find_element_by_android_uiautomator， 传 入 的 参数 是 一 个 字符 串 ， 该 
字符 串 符合 UiAutomator 控 件 查找 的 Java 语 法 。 在 本 示例 中 ， 脚 本 首先 
通过 判断 控件 可 以 滑动 的 属性 找到 了 一 个 UiScrollable 的 对 象 ， 然 后 在 
UiScrollable 的 对 象 中 根据 Child 控 件 的 类 型 android.widget.LinearLayout 


和 显示 的 文本 信息 查找 子 控件 。 这 种 方法 的 优点 是 脚本 不 需要 知道 列 
表 项 的 具体 位 置 ， 更 加 通用 。 脚 本 在 运行 时 会 目 动 上 下 滑动 列表 ， 直 
到 找到 满足 条 件 的 列表 项 为 止 。 更 多 关于 使 用 UiAutomator 的 信息 请 参 
考 第 7 章 的 内 容 或 者 登录 Android 开 发 者 网 站 查询 。 


def getListIitemByText(cls, searchText): 

return cls.uiHelper._driver.find element_by_android uiautomator('new 
UiScrollable(new UiSelector().scrollable(true)).getchildByText(new UiSelector(). 
className(android.widget.LinearLayout), "%s")' %searchText) 


6.4 本章 小 结 


本 章 先 概要 介绍 了 Appium 框 染 的 原理 、 优 缺点 以 及 如 何 判 断 该 工 


具 是 否 适用 于 项 目的 目 动 化 测试 ， 然 后 前 述 了 如 何 搭 建 Appium 的 测试 
环境 ， 并 结合 Android 系 统 目 带 的 联系 人 功能 讲述 了 如 何 利 用 Python 语 


言 写 一 个 Appium 的 自动 化 测试 脚本 。 接 下 来 结合 笔者 在 腾讯 地 图 项 目 
中 的 实践 经 验 ， 阅 述 了 在 实际 项 目 中 如 何 高 效 地 利用 Appium 实 施 自动 
化 测试 和 在 实施 过 程 中 经 常 遇 到 的 一 些 问题 的 原因 与 解决 方法 。 和 希望 
读者 能 在 阅读 本 章 后 ， 对 Appium 有 一 个 较 深 的 理解 ， 能 将 Appium 和 
笔者 的 经 验 应 用 到 项 目 中 去 。 


第 7 章 ”Android App 速 度 测 试 


移动 互联 网 在 快速 发 展 ，App 的 苋 争 呈现 日 热 化 。App 的 性 能 表现 
不 再 是 可 有 可 无 的 指标 ， 而 是 影响 用 户 选 择 或 者 放弃 一 款 App 的 重要 依 
据 。 以 手机 浏览 器 为 例 ，CNNIC 2013 年 发 布 的 一 份 《中 国手 机 浏览 器 
用 户 研究 报告 》 显 示 ， 手 机 浏览 器 自身 的 性 能 和 速度 是 影响 用 户 选 择 
的 最 重要 因素 ， 如 图 7-1 所 示 。 


手机 浏览 器 自身 的 性 能 和 速度 
手机 浏览 器 自身 的 功能 内 容 丰 富 程度 
手机 浏览 器 的 品牌 和 口碑 

周转 同事、 朋友 正 在 使 用 的 浏览 带 
手机 自 带 的 浏览 器 

手机 浏览 器 的 排名 

同 品牌 其 他 应 用 软件 的 使 用 情况 

PC 端 使 用 浏览 器 的 品牌 


其 他 


图 7-1 影响 用 户 选 择 手机 浏览 融 的 因 和 又 


一 旦 性 能 出 现 间 题 ， 用 户 很 可 能 会 因此 而 流失 。 据 统计 ， 当 App 网 
页 打开 时 间 超 过 2000ms 时 ， 用 户 开始 流失 ， 当 App 交 互 执行 性 能 时 间 
达到 400ms 时 ， 性 能 开始 出 现 隐患 。 


本 章 主 要 介绍 在 众多 性 能 测试 项 中 扮演 最 重要 角色 的 速度 测试 。 
第 一 部 分 会 列举 影响 用 户 体验 的 速度 测试 场景 。 第 二 部 分 引出 速度 测 
试 的 多 种 方法 ， 并 介绍 这 些 方法 的 优 缺 点 。 第 三 部 分 以 两 个 实例 详细 
说 明 速 度 测试 方法 在 手机 浏览 器 项 目 中 的 实践 过 程 。 第 四 部 分 总 结 速 
度 测试 的 测 斌 心得。 本章 知识 结构 图 如 图 7-2 所 示 。 


速度 测试 场景 
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图 7-2 本章 知 识 结构 图 


7.1 速度 测试 场景 
哪些 场景 需要 做 速度 测试 ? 笔者 认 为 可 以 遵循 以 下 两 个 原则 ， 


1. 重 要 性 原则 


重要 性 原则 的 意思 是 ， 越 重要 的 场景 束 越 有 必要 去 做 速度 测试 。 
一 个 场景 的 重要 性 可 以 通过 用 户 对 该 场景 的 使 用 频率 以 及 当前 版 本 的 
重点 功能 来 评 佑 。 以 手机 浏览 郁 为 例 ， 通 过 用 户 数据 收集 可 以 得 知 : 
浏览 器 启动 、 退 出 、 搜 索 栏 点 击 这 三 个 操作 的 日 使 用 用 户 数 都 在 100 万 
以 上 ， 所 以 笔者 认为 这 三 个 操作 的 速度 需要 重点 保证 ( 表 7-1) 


表 7-1 手机 浏览 器 各 功能 日 使 用 用 户 数 (示意 数据 ) 


功能 项 类 型 功能 日 使 用 用 户 数 
乒 | 


内 核 1983471 


地 址 栏 


功能 日 使 用 用 户 数 


2. 痛 点 原则 


痛 点 原则 的 意思 是 ， 越 是 让 用 户 感觉 难受 的 、 抱 怨 的 速度 问题 就 
越 有 必要 做 速度 测试 。 通 常 可 以 从 用 户 反 馈 信 息 和 用 户 调查 问卷 中 ， 
了 解 到 相关 信息 并 做 出 选择 。 还 是 以 手机 浏览 角 为 例 ， 有 不 少 浏览 天 
反馈 新 建 多 窗口 慢 ， 测 试 组 对 新 建 多 窗口 场景 进行 了 速度 测试 。 


测试 场景 具有 多 方面 属性 ， 除 了 需要 选择 测试 动作 之 外 ， 还 需要 
指定 其 他 属性 。 比 如 网 络 、 机 型 、 是 否 有 缓存、 是 冷 局 动 还 古 热 局 动 
等 。 手 机 浏览 器 测试 团队 为 了 优化 弱 网 络 情况 下 的 网 页 打开 速度 ， 就 
曾经 进行 过 多 次 外 场 测 试 。 选 取 地 铁 、 公 交 、 考 当 荔 等 用 户 常见 的 弱 
网 络 场所 进行 网 页 打开 速度 测试 ， 并 有 针对 性 地 优化 网 页 打开 速度 。 


表 7-2 是 手机 浏览 句 选 取 的 速度 测试 场景 ， 供 大 家 参考 。 


表 7-2 五 种 常见 的 速度 测试 场景 


启动 速度 用 户 点 击 手机 浏览 器 岁 标 到 起 始 页 出 现 的 时 间 用 户 必 经 操作 

多 窗口 操作 速度 用 户 点 击 多 窗口 到 多 窗口 界面 出 现 的 时 间 用 户 反 馈 性 能 问题 重 灾 区 
打开 网 页 速度 打开 一 个 网 页 的 速度 手机 浏览 器 的 最 核心 操作 
下 载 速 度 下 载 一 个 App 的 速度 基础 功能 


视频 打开 速度 点 击 播放 一 个 视频 到 视频 出 现 第 一 帧 的 时 间 重点 推广 功能 


@@ 各 词 解释 。 冷 启动 与 热 启动 


Android 系 统 的 Activity 退 出 之 后 ， 应 用 的 进程 并 不 会 被 * 杀 死 ”， 而 
是 保留 在 那里 。 当 再 次 打开 App 的 Activity 时 ， 会 从 已 有 的 进程 中 创建 


Activity， 是 为 “ 热 启动 "”。 若 打开 Activity 时 没有 进程 ， 则 会 先 创建 一 个 
进程 ， 再 在 新 建 的 进程 中 打开 Activity， 是 为 “ 冷 启动 ”。 


7.2 ”速度 测试 的 六 大 方法 


选 是 了 测试 场景 之 后 ， 束 蕊 上 开始 测试 。 做 速度 测试 不 需要 高 深 
的 技术 和 专门 的 设备 ， 简 单一 个 秒表 (智能 手机 都 有 秒表 功能 ) 、 一 
文笔 、 一 部 手机 就 可 以 开始 测试 了 。 操 作 过 程 也 很 位 单 ， 以 手机 浏 宽 
絮 局 动 速 度 为 例 ， 步 又 如 下 : 


(1) 确保 手机 已 经 安装 手机 浏览 器 ， 并 且 未 局 动 。 


(2) 活动 桌面 让 手机 浏览 器 图 标 处 于 当前 桌面 。 秒 表 清 零 。 


(3) 点 击 手机 浏览 器 图 标的 同时 按 下 秒表 ， 开 始 计时 。 


(4) 手机 浏览 器 自动 跳 过 欢迎 页 显示 起 始 页 (启动 完成 ，。 此 页 
面 出 现 立 马 按 停 秒表 ， 计 时 结束 。 


(5) 记录 秒表 时 间 。 


(6) 重复 (1) ~ (5) 步 多 次 ， 获 得 多 次 测试 结果 取 平 均值 。 


以 上 惑 是 一 个 最 简单 的 速度 测试 过 程 。 这 个 过 程 可 以 分 成 以 下 三 


部 分 。 


Kt 


1. 操 作 手 机 


操作 手机 最 简单 的 方法 就 是 手动 点 击 屏幕 。 这 种 方法 优点 是 简 
单 、 灵 活 ， 对 不 同 手 机 的 兼容 性 高 ;而 缺点 是 容易 点 错 、 损 作 效率 不 
高 、 大 量 重 复 操作 容易 疲劳 。 所 以 手动 点 击 屏幕 的 方法 通常 用 于 初次 
摸底 测试 ， 以 便 对 被 测速 度 指 标 有 一 个 大 致 的 了 解 。 当 需要 第 规 测 试 
时 ， 通 常会 选用 自动 化 方式 操作 手机 。 本 书 在 其 他 章节 中 对 Monkey、 
UIAutomator、Robotium 等 自动 化 工具 的 使 用 方法 已 有 介绍 ， 这 里 不 再 


资 述 了 。 


2. 记 了 采 测 试 结果 


记录 测试 结果 指 的 是 识别 被 测 操作 开始 和 结束 的 时 间 并 记录 下 
来 。 上 例 中 ， 识 别 开 始 和 结束 的 时 间 使 用 的 是 人 眼 ， 并 通过 纸 笔 来 记 
杂 该 时 间 。 和 手动 点 击 屏 幕 方 法 一 样 ， 人 上 服 识 别 方法 位 单 、 灵 活 , 但 
不 适用 于 大 量 的 重复 测试 ， 也 无 法 保证 精确 度 。 所 以 需要 引入 一 些 目 
动 化 的 识别 方法 ， 包 括 打 印 日 志 计时 法 、 图 像 分 析 计 时 法 、Hook 方 案 
计时 法 、 网 络 包 分 析 法 等 。 这 些 方法 正 古 速度 测试 研究 的 主要 技术 ， 
本 草 后 面 会 详细 展开 介绍 。 


3. 对 测试 结 来 进行 数据 处 理 得 到 测试 值 


对 测试 结果 进行 数据 处 理 得 到 测试 值 指 的 是 通过 一 组 测量 值得 出 
一 个 平均 值 的 过 程 。 因 为 每 次 测试 时 的 手机 状态 、 网 络 状 态 会 有 不 
同 ， 同 一 个 操作 多 次 测量 的 结果 也 会 有 仿 差 ， 所 以 通 肖 需要 以 测试 多 


次 取 平 均值 的 方法 来 减少 误 莹 。 如 何 去 除 粗大 毫 过、 如 何 取 平 均值 、 
如 何 评 估 结 果 的 误差 属于 误差 统计 学 的 研究 范畴 ， 本 书 不 准备 讨论 这 
部 分 内 容 。 但 笔者 会 在 下 面 案 例 介绍 环节 中 将 有 用 的 经 验 介绍 给 


a 


夭 ， 


下 面 开始 逐一 介绍 各 种 速度 测试 方法 以 及 它们 的 使 用 场景 。 


7.2.1 描 妆 计时 法 


前 文 已 经 提 到 ， 抬 表 是 大 家 最 第 见 、 最 容易 想到 的 计时 方法 ， 如 
图 7-3 所 示 。 操 作 的 同时 开始 计时 ， 预 期 结果 展示 完成 时 结束 计时 ， 其 
间 所 花费 的 时 间 束 一 目 了 然 了 。 这 种 方法 特别 适合 测量 指标 时 间 长 
(大 于 10s) 、 对 测试 精度 要 求 较 低 的 临时 性 测试 。 但 是 如 果 软 件 的 操 
作 都 是 短 短 几 秒 或 者 1s 内 完成 的 动作 ， 用 这 种 方式 产生 的 误差 束 显 得 
太 大 了 ， 会 直接 导致 测试 结论 的 错误 。 


图 7-3 ”的 表 计 时 法 


也 就 是 说 ， 通 过 测试 时 间 、 精 度 要 求 和 测试 频率 这 三 个 条 件 可 以 
判断 一 项 速度 测试 是 否 适合 用 拘 表 计时 法 。 以 手机 浏览 器 选 定 的 五 种 
典型 测试 场景 为 例 ， 下 载 速度 场景 测试 时 间 长 (10~50s) 、 精 度 要 求 
低 (500ms) 、 测 试 频率 低 (每 个 版 本 一 次 ) ， 所 以 适合 用 拘 表 计时 法 
测试 。 而 启动 速度 、 多 窗口 操作 速度 、 网 页 打开 速度 和 视频 打开 速度 
的 精度 要 求 都 在 50ms 以 下 。 如 表 7-3 中 的 场景 用 拘 表 计时 法 就 无 法 满足 
要 求 。 


表 7-3 五 种 典型 测试 场景 的 精度 要 求 


速度 测试 场景 测试 频率 
多 窗口 操作 速度 每 个 版 本 测试 
网 页 打开 速度 每 天 DailyBuild 测试 
视频 打开 速度 人 全 本 


有 没有 更 精确 一 点 儿 的 方法 呢 ? 来 看 看 打印 日 志 计 时 法 吧 


279% 1DIE 


这 个 其 实 很 好 理解 ， 怠 是 在 关键 节点 通过 接口 打印 出 有 用 的 日 
志 ， 分 析 这 些 日 志 即 可 得 出 开始 和 结束 的 时 间 。 比 如 ， 假 设 执行 某 个 
操作 时 调用 的 第 一 个 接口 代码 如 下 : 


StartUp(){ 
// 


预期 结果 显示 完成 时 调用 的 接口 代码 如 下 : 


endUp( ){ 
// 


那么 在 编码 阶段 ， 可 以 在 这 两 个 接口 中 分 别 打印 当前 有 时间， 如 下 
面 的 代码 所 示 。 


startUp(){ 
print(os,time()) 


print(os.time()) 


这 样 在 执行 一 次 这 个 操作 时 ， 束 会 打印 两 个 时 间 蔬 点， 这 两 个 时 
间 节 点 能 够 精确 地 计算 这 个 操作 完成 的 时 间 。 


具体 以 网 页 打开 速度 为 例 ， 在 开始 打开 网 页 时 浏 哎 絮 会 调用 一 个 
叫 onStart 的 函数 。 而 在 网 页 打开 完成 时 ， 浏 换 右 会 调用 一 个 叫 onFinish 
的 函数 。 这 样 ， 只 要 在 这 两 个 接口 中 打印 出 当前 时 间 ， 在 执行 打开 网 
页 操作 时 ， 束 会 打印 开始 和 完成 的 时 间 节 点 。 这 两 个 时 间 节 点 能 够 精 
确 地 计算 打开 网 页 完成 的 时 间 。 除 此 之 外 ， 还 能 打印 出 一 些 过 程 画 数 
的 耗 时 ， 这 样 便于 分 析 程 序 慢 在 哪里 ， 是 非常 不 错 的 一 个 方式 。 


但 这 种 方式 也 有 一 些 不 足 之 处 。 羊 先 ， 测 试 前 需要 源码 ， 而 苋 品 
的 源码 不 可 能 得 到 ， 这 样 就 无 法 与 范 品 对 比 。 其 次 ,日 志 打 印 时 间 和 
用 户 感知 时 间 可 能 有 偏差 。 以 网 页 的 打开 时 间 为 例 ， 程 序 认为 onFinish 
函数 执行 时 首 屏 就 出 来 了 ， 但 浑 染 和 上 屏 的 耗 时 程序 无 法 获知 ， 用 户 
感知 到 的 首 屏 会 比 onFinish 的 打印 时 间 有 要 晚 ， 而 通常 项 目 组 更 关注 的 是 
用 户 感知 到 首 屏 的 显示 时 间 。 


有 没有 能 对 比 竞 品 ， 并 且 更 能 体现 用 户 感知 的 速度 的 测试 方法 
呢 ? 来 看 看 图 像 分 析 计 时 法 ! 


7.2.3 图 像 分 析 计 时 法 


图 像 分 析 计 时 法 的 天体 思路 是 用 工具 记录 操作 过 程 每 一 时 刻 的 屏 
幕 图 像 和 图 像 对 应 的 时 间 ， 然 后 通过 分 析 算 法 找 出 开始 和 结束 的 图 
像 ， 从 而 获得 开始 和 结束 的 时 间 ， 如 图 7-4 所 示 。 
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外 嵌 记 者 借 人 权 发 难 王 租 扰 斥 
i 


图 7-4 ”通过 算法 找 出 开始 帧 和 结束 帧 


外 媒 沁 者 僧人 权 发 难 三 赖 想 斥 


这 种 方法 理论 上 和 人 有 眼 的 感知 一 致 ， 而 且 不 需要 修改 程序 源码 。 
准确 性 则 要 看 使 用 什么 工具 来 获取 图 像 。 一 般 都 能 达到 每 秒 30 帧 或 以 
上 的 频率 ， 也 就 是 说 精度 能 控制 在 33ms 以 内 。 获 取 图 像 的 工具 有 的 直 
接生 成 图 片 ， 有 的 生成 的 是 视频 ， 有 的 是 测试 手机 上 安装 的 App， 有 的 
则 需要 借助 别 的 设备 来 完成 图 像 获 取 。 根 据 特性 的 不 同 可 以 分 为 以 下 


四 种 ， 截 屏 、 录 屏 、 拍 照 、 录 像 ， 见 表 7-4 。 


表 7-4 ”获取 图 像 的 四 种 方式 


WT 
获取 图 片 截屏 拍照 
获取 视频 录像 


这 四 种 方式 的 具体 工具 推荐 以 及 这 些 工 具 的 优 缺 点 见 表 7-5。 大 家 
可 以 根据 目 喘 情况 选择 适合 目 己 的 。 


截屏 和 拍照 得 到 的 图 片 可 以 直接 分 析 开 始 和 结束 的 时 间 ， 视 频 则 
需要 先 经 过 分 帧 成 为 图 片 才能 分 析 开 始 和 结束 的 时 间 。 同 一 个 测试 场 
景 要 测试 多 次 取 平 均值 ， 而 且 每 次 测试 需要 处 理 很 多 分 帧 图 片 。 人 工 
找 起 来 很 费劲 ， 所 以 智能 分 析 算法 必 不 可 少 。 通 过 图 片 分 析 开 始 和 绪 
束 的 时 间 的 算法 成 为 图 像 分 析 方 法 的 关键 。 


表 7-5 ”获取 疼 像 的 四 种 方式 的 优 缺 总 


记录 方式 推荐 工具 缺点 
使 用 Android 源 代 码 中 的 capture- | 1. 查看 图 片 即 可 直接 计算 时 | 1. 全 程 高 速 截屏 用 占用 非常 
Screen 接口 间 (每 一 张 图 片 都 有 生成 时 间 ) | 多 的 手机 系统 资源 ， 可 能 影响 
截屏 详细 使 用 方法 参见 8.3.4 节 2. 不 需要 另外 的 设备 被 测 软 件 本 号 的 性 能 
帧 率 : 16 帧 /各 3. 图 片 清晰 好 处 理 (可 以 真 | 2. 图 片 保 存在 手机 上 占用 手机 
实 记录 屏幕 像素 ) 存储 空间 ， 需 要 及 时 复制 至 PC 
Android 4.4 版 本 后 自 带 录 屏 工 具 | 同 截 屏 方式 1. 需要 先 分 帧 才能 计算 时 间 ， 
录 屏 adb shell screenrecord 相对 厅 烦 
帧 率 ， 60 帧 / 秒 2. 其 他 同 截屏 方式 
暂 未 发 现 好 用 的 工具 1. 不 需要 占用 手机 系统 资源 1. 需要 另 一 台 设 备 ( 如 相 
拍照 2. 不 用 分 帧 直接 通过 图 片 就 | 机 )， 记 录 过 程 容易 出 错 
能 计算 时 间 (每 一 张 图 片 都 有 | 2. 图 片 不 清晰 (光线 、 对 焦 、 
生成 时 间 ) 拍摄 角度 等 都 对 成 像 有 影响 ) 
罗技 C920 网 络 摄像 头 + 罗技 摄 不 需要 占用 手机 系统 资源 1. 需要 另 一 台 设备 ， 记 录 过 
像 头 软件 Logitech Webcam Software 程 容易 出 错 (一 种 出 错 是 摄像 
帧 率 : 30 帧 /种 头 软件 卡 死 ; 另 一 种 出 错 是 录 
录像 像 操 作 与 手机 操作 不 同步 ) 


2. 图 片 不 清晰 (光线 、 对 焦 、 
拍摄 角度 等 都 对 成 像 有 影响 ) 
3. 需要 先 分 帧 才能 计算 时 间 ， 


相对 麻烦 


其 基本 思路 其 实 很 简单 ， 吏 是 找到 开始 帧 和 结束 帆 的 特征 ， 并 通 
一 定 的 图 像 算 法 识别 到 这 个 特征 。 但 实际 操作 起 来 却 会 过 到 不 少 问 


题 ， 下 面 莹 试 逐 一 解决 这 些 问 题 。 


1. 识 别 开 始 由 


开始 帧 区 是 打开 网 页 时 上 点击“ 前往 ”按钮 那 一 刻 的 图 片 ， 又 或 者 是 
下 载 应 用 点 击 “ 下 载 ” 按 钮 那 一 刻 的 图 片 。 这 听 起 来 似乎 很 简单 ， 但 事 
实 上 这 个 时 间 点 在 屏幕 上 有 了 时 十 没有 显示 的 。 比 如 点 击 “ 前 往 ” 按 钮 ， 
程序 可 能 需要 执行 一 些 逻 辑 后 才 让 “前 进 ” 按 钮 显示 为 反击 态 ， 这 样 束 
没 办 法 准确 找 出 开始 由。 


那 坚 么 办 ? 


几经 探索 ， 笔 者 终于 找到 了 解决 办 法 : 在 界面 上 留 下 操作 的 痕 
迹 。 比 如 点 击 时 在 点 击 位 置 绘制 一 个 日 点 ， 兴 动 时 绘制 滑动 的 轨迹 。 
这 个 日 点 需要 打开 “系统 设置 -开发 者 选项 -显示 触摸 操作 ” 才 会 显示 
出 来 。 设 置 弄 面 如 图 7-5 所 示 。 设 置 后 效果 如 网 7-6 所 示 。 


显示 触摸 操作 


图 7-5 ”设置 “显示 触摸 操作 ”界面 


下 午 4:51 


昌 sina.cn 


图 7-6 ”设置 “显示 触摸 操作 ”后 效 采 


测试 数据 表明 ， 点 击 事件 发 生 到 日 点 显示 之 间 的 延 时 小 于 30ms， 
小 于 采 像 的 分 帧 间隔 。 


日 态 识 别 的 算法 会 在 实例 章节 中 予以 介绍 ， 这 里 丈 不 展开 和 叙述 
了 O 


2. 识 别 结束 帧 


结束 幅 就 古 测 试 场景 动作 完成 的 那 一 帆 ， 比 如 打开 网 页 场景 中 网 
页 铺面 屏幕 ， 叉 比如 下 载 场景 中 显示 下 载 完 成 。 对 于 动作 完成 界面 不 
变 的 情形 ， 结 束 帆 很 好 找 ， 直 接 用 图 像 对 比方 法 束 能 找到 。 


如 网 7-7 所 示 ， 网 页 打开 之 后 束 不 再 要 化 了 。 这 时 可 以 将 最 后 一 张 
图 片 作 为 结束 帆 标 准 图 片 ， 然 后 从 前 往 后 将 每 个 图 片 依 次 与 这 个 标准 
图 片 进行 对 比 。 当 图 像 对 比 一 致 时 ， 则 认为 找到 了 结束 帧 。 


图 7-7 网 页 打开 后 页 面 不 再 变化 


但 如 果 动 作 场 景 完成 后 ， 界 面 还 会 变化 ， 比 如 手 腾 网 打开 后 ， 大 
图 幻灯 片 还 在 来 回 切 换 ， 这 种 情况 惑 变 得 复 末 了 ， 这 时 就 需要 采取 局 
部 图 像 对 比 等 更 有 针对 性 的 方法 来 找 结束 帧 。 详 情 见 实例 。 


看 到 这 里 ， 想 必 大 家 也 看 出 了 图 像 分 析 方 法 的 缺点 : 分 析 操 作 烦 
琐 、 实 现 目 动 化 难度 大 、 有 出 错 概 率 需 要 人 工 校 验 。 


那么 还 有 更 好 的 方案 吗 ? 


7.2.4 Hook 方案 计时 法 


对 于 速度 的 感知 ， 从 人 的 角度 讲 ， 以 按 下 手指 ， 人 感知 为 开始 
到 菜单 完全 弹出 ， 人 感知 为 结束 ， 那 么 这 两 个 点 是 否 可 以 对 应 到 程序 
里 ? 当然 可 以 ! 从 程序 的 角度 讲 ， 按 下 手指 ， 即 系统 收 到 触摸 消息 ， 
采 单 完全 弹出 ， 则 可 以 对 应 到 半音 绘制 结束 ， 如 图 7-8 所 示 。 


触摸 屏幕 来 单 展开 


点 击 信 息 


图 7-8 速度 的 定义 


如 何在 程序 里 获取 点 击 消息 和 绘制 完成 这 两 个 时 间 市 点 ? 


获取 点 击 消息 ， 考 虑 Android 扩 击 消息 分 发 流程 ， 如 图 7-9 所 示 。 


Android 程 序 的 用 户 点 击 消 息 处 理 ， 一 般 是 由 View 来 完成 的 。 如 果 
可 以 在 View.dispatchTouchEvent 或 者 View.onTouchEvent 这 两 个 函数 执行 
前 记录 下 时 间 (比如 打 个 log) ， 那 么 就 可 以 获取 用 户 触 摸 屏 幕 的 时 
间 。 如 果 View 被 添加 了 onTouchListener， 那 么 View.onTouchEvent 函 数 
将 不 会 执行 ， 所 以 ， 通 过 hook View.dispatchTouchEvent 记 录用 户 点 击 消 
息 的 时 间 。 


获取 绘制 完成 ， 先 来 了 解 Android 绘 制 的 大 概 流程 ， 如 图 7-10 所 


修 ° 


Activity 


i 全 由 有 > ACTION 
: 弟 DispatchTouchEvent 发 - 
传递 ispatchTouchEven 触发 0 


True 


ViewGroup 


onInterceptTouchEvent 


图 7-9 ”Andriod 点 击 消息 分 发 流程 


垂直 同步 消息 
Choreographer. onVsync 
Choreographer. doFrame 
开始 遍历 绘制 
ViewRootImpl .performTraversals 
ET 


图 7-10 ”Android 绘 制 流程 一 


Android 控 件 的 绘制 ， 从 ViewRootImpl.performTraversals 开 始 ， 函 数 
将 遍历 每 个 view， 根 据 需 求 依 次 进行 measure (计算 ) 、layout ( 布 
局 ) 、draw (绘制 ) 的 过 程 。View.draw 画 数 是 控件 真正 绘制 的 函数 。 


继续 跟踪 View.draw， 由 于 现在 的 4.X 手 机 基本 都 支持 硬件 加 速 ， 所 
以 View.draw 最 终 是 调用 GPU 进行 绘制 的 ， 也 就 是 调用 
android.view.HardwareRenderer$GLRender.draw。 在 这 个 函数 里 面 ， 程 
序 分 三 步 完 成 了 控件 的 绘制 ， 如 图 7-11 所 示 。 


(1) CPU 汤 历 每 个 控件 ， 录 制 绘图 命令 ， 生 成 baild DisplayList 。 


(2) GPU 回放 draw DisplayList， 将 图 形 绘制 到 buffer 上 。 


(3) 交换 buffer， 真 正在 屏幕 上 显示 出 来 。 


GlRenderer.draw 


buildDisplayList 
drawDisplayList 


交换 buffer 


图 7-11 ”Android 绘 制 流程 二 


在 Android 手 机 上 ， 如 有 果 打 开 “ 开 发 者 选项 -GPU” 哇 现 模 式 分 析 ， 
系统 束 会 对 上 述 三 个 函数 进行 计时 ， 可 以 采用 adb shell dumpsys gfxinfo 
看 到 App 的 每 一 帧 的 详细 绘制 情况 ， 如 图 7-12 所 示 。 


其 中 ，Draw 统 计 的 是 buildDisplayList 耗 时 ，Process 统 计 的 是 


drawDisplayList 耗 时 ，Execute 统 计 的 是 swapBuffers 耗 时 。 


经 过 上 面 的 分 析 可 知 ，Android 系 统 是 根据 GI]Rendererdraw 函 数 来 
调试 控件 绘制 的 ， 所 以 可 以 执行 hook G]Renderer.draw， 如 果 这 个 函数 
执行 完毕 ， 则 确定 为 当前 帧 绘制 完毕 。 


Profile data in ms: 


[TA i Cs 
Draw Process Execute 
6 .82 20.63 @.33 
1 E @.55 
了 .39 B.39 
19-19 @.41 
[5 @.45 
5.98 5 8.56 
?7.21 2 B-67 
9 .92 - 6.41 
4.81 & @.35 
23 .69 B-56 
?了 -30 3.19 
19-.02 @.51 
6.27 8.37 
Ce 2 [5 
8.99 > @.37 
le 6.68 
6.86 本 @.63 
11.84 @.58 
16.83 : 8.84 
20.48 = 8.81 
19.12 .7?0 1.75 
[Sp 0.90 
4.81 @.84 
4-.26 人 日 .31 


图 7-12 Dump 绘制 信息 


到 目前 为 止 ， 已 经 确定 了 两 个 关键 函数 : 


(1) View.dispatchTouchEvent 一 获取 用 户 点 击 时 间 。 
(2) GlRenderer.draw 获取 绘制 完成 时 间 。 
通过 计算 这 两 个 时 间 差 ， 丈 可 以 得 到 从 用 户 点 击 某 单 键 到 沫 单 弹 
出 来 的 时 间 。 


熟悉 了 原理 ， 通 过 Xposed 框 架 来 实现 具体 的 Hook 代 码 编写 。 
Xposed 框 架 是 一 个 Android 系 统 扩 展 库 ， 安 效 了 这 个 框架 以 后 ， 有 各 种 
各 样 的 插件 供用 户 使 用 。 这 些 插件 可 以 任意 修改 系统 ， 小 到 修改 下 挨 
号 界面 背景 色 ， 大 到 修改 整个 拨号 界面 ， 都 可 以 实现 。 


Xposed 框 架 支 持 4.X 主 流 系统 ， 当 然 还 是 需要 ROOT 的 手机 。 


要 完成 一 个 Xposed 插 件 ， 需 要 引入 Xposed 的 jar 包 ， 并 且 实 现 
IXposedHookLoad-Package 接 口 ， 如 图 7-13 所 示 “。 


需要 hook 一 个 Java 函 数 非常 简单 ， 只 需要 传 入 Java 类 全 名 ， 方 法 
名 ， 参 数 类 型 ， 其 他 则 交 由 Xposed 框 染 处 理 。 


四 IMessageHan... Recordjava [MonitorSev.. 四 ReedionU | 国 TetModulejava 53 | 对 


3@ import com.tencent.qqdriver.xposed.performance.monitor.MonitorClient;[] 


public static final String TAG =“MethodHook ; 
public static final String Debu9gTA6 = “HookDebug ”; 


@0verride 
public void handleLoadPackage(LoadPackageParam lpparam) throws Throwable 


if (lpparam.processName.equalsIgnoreCase("“android")) { 
// system server 
MonitorServer server = new MonitorServer(); 
server.hookSystemServer(lpparam); 
} else { 
// app under test 
MonitorClient client = getClientForApp(lpparam); 
if (client != null) { 
client.hookTestApp(lpparam); 
} 


图 7-13 ”Xposed Hook 实 现 


7.2.5 ”网 络 包 分 析 法 


网 络 包 分 析 法 不 是 一 种 通用 的 速度 测试 方法 ， 因 为 有 的 速度 测试 
场景 不 涉及 网 络 交 互 。 同 时 ， 它 也 不 能 准确 度量 某 个 场景 的 用 户 感 知 
速度 ， 因 为 网 络 包 传 输 完 网 页 不 一 定 束 能 显示 出 来 。 但 是 ， 它 确实 是 
发 现 程序 慢 在 哪里 的 重要 方法 。 


首先 ， 需 要 抓 取 网 络 包 。 在 PC 端 ， 可 选 的 抓 包工 具 比 较 多 ， 包 括 
Wireshark、HttpWatch 等 。 而 在 手机 端 ， 推 荐 使 用 Tcpdump 。 


Tcpdump 使 用 方法 如 下 : 

步骤 1: 手机 村 有 ROOT 权限 

步骤 2: 下 载 Tcpdump 

步骤 3: adb push c: \wherever you_put\tcpdump/data/local/tcpdump 
步骤 4: adb shell chmod 6755/data/local/tcpdump 

步骤 5: adb shell，su 获 得 ROOT 权限 

步骤 6: cd/data/local 


步骤 7: ../tcpdump-p-vv-s 0-w/sdcard/capture.pcap 


步骤 8: adb pull/sdcard/capture.pcap d: / 


通过 以 上 八 个 步 又 ， 网 络 包 就 能 成 功 抓 取 并 从 手机 复制 到 PC 的 D 
盘 根 目录 下 ， 是 一 个 .pcap 格 式 文件 ， 需 要 借助 Wireshark 等 工具 才能 打 
开 查 看 。 


加 注音 天 于 Tcpdump 更 详细 的 信息 和 工具 下 载 可 以 访问 以 下 两 


个 网 站 : 
Tcpdump 介 绍 : http://baike.baidu.com/view/76504.htm 。 


Tcpdump 下 载 : http://www.tcpdump.org/#latest-release 。 


接 下 来 看 看 如 何 分 析 一 个 网 络 包 。 


以 网 页 打开 场景 为 例 ， 通 过 网 络 包 分 析 可 以 谢 析 主 资源 以 至 每 个 
资源 的 连接 、 请 求 、 等 待 、 接 收 每 个 环节 的 耗 时 ， 这 对 找到 程序 慢 
的 原因 以 便 有 针对 性 地 优化 无 疑 作用 巨大 。 


图 7-14 所 示 为 通过 http://pcapperf.appspot.com/ 在 线 工具 分 析 一 个 网 
络 包 的 结果 。 


由 GET sina.cn 200 OK sina,.cn 18.3 KB 
由 GET favicon.ico 200 C sina.cn 5.3 KB 


由 POST request 200 OK 183.233.224.20: 1.8 KB 
由 GET hm.js?816cbe28¢ 200 0 hm.baidu.com 

田 GET suda_log.min.js 200 0| mjs.sinaimg.cn My 8ims DNS Lookup 
由 GET suda_map.min.js 200 OK mijs.sinaimg.cn 7 | T 9.84s Connecting 
由 GET addjs.min.js?v=0 200 OK mijs.sinaimg.cn a Oms Sending 

由 GET a.gif2V=2.3.1&C] OK beacon.sina.com n 8ms Waiting 

由 GET config.js?t=4844 ol mjs.sinaimg.cn T 1ms Receiving 

由 GET hm.gif?cc=0&ck= OK hm.baidu.com 
由 GET home.min.css?v= OK mijs.sinaimg.cn 外 | 14: DOM Loaded 
由 GET w640h320zll50t OK k.sinaimg.cn 了 m , Page Loaded 
由 GET w640h320zll50t 200 OK k.sinaimg.cn 

9 GET Ilz2X1.jpg 200 Of mjs.sinaimg.cn 


由 GET w640h320zll50t 200 ol k.sinaimg.cn 
国 4X3 jpg 2000 mis,sinaimg 


图 7-14 在线 工具 分 析 网 络 包 的 结 


从 图 7-14 中 可 以 看 出 sina.cn 是 这 个 网 页 的 主 资源 ， 大 小 是 18.3KB， 
资源 请 求 总 耗 时 74ms; favicon.ico 是 sina.cn 的 一 个 子 资源 ， 大 小 是 
5.3KB。 从 4.85s 开 始 发 起 请 求 ，DNS 查 询 耗 时 81ms; 连接 服务 器 耗 时 
9.84s; 请 求 包 传输 耗 时 0ms; 等 待 服务 器 回应 耗 时 8ms; 回 包 传输 耗 时 


lms° 


除 此 之 外 ， 还 可 以 看 到 子 资 源 列 表 中 有 一 些 js、jpg、gif 等 资源 。 


通过 这 些 资源 的 请 求 发 起 时 间 和 连接 、 传 输 时 间 ， 开 发 人 员 就 基 
本 可 以 找到 网 络 测试 慢 的 原因 了 。 


7.2.6 ”各 种 速度 测试 方法 的 优 缺 点 


下 面 总 结 一 下 五 种 速度 测试 方法 的 效果 和 优 缺 点 ， 


方法 
抬 表 计时 法 


打印 日 志 计 时 法 


图 像 分 析 计 时 法 


Hook 方案 计时 法 


网 络 包 分 析 法 


见 表 7-6。 


表 7-6 五 种 速度 测试 方法 的 效果 和 优 缺 点 


使 用 秒表 。 分 别 记 
录 被 测 操 作 开 始 和 结 
束 的 时 间 

分 别 在 被 测 操作 开 
始 和 结束 的 时 候 打 印 
日 志 ， 然 后 统计 时 间 
(包括 App 日 志 、 系 统 
Logcat、Trace 文件 等 ) 

用 录 屏 或 高 速 摄像 
头等 方式 将 操作 过 程 
录 下 来 。 然 后 通过 分 
帧 、 调 整 、 统 计 系 列 
过 程 得 出 耗 时 

对 系统 函数 插 桩 ， 
记录 时 间 惟 ， 计 算 时 
间 消 耗 

通过 分 析 网 络 包 等 
间接 手段 计算 时 间 


这 些 测试 方法 与 速 


表 7-7 


大 到 测试 目的 


1. 简单 
2. 真实 


度量 1. 简单 、 准 确 
发 现 慢 在 哪里 2. 容易 实现 自动 化 
3. 方便 统计 过 程 指 
标 ， 找 出 慢 在 哪里 


1. 中 等 精度 
2. 与 用 户 感知 一 致 


1. 操作 完毕 立即 出 
结果 

2. 高 精度 

通过 分 析 网 络 包 发 
现 慢 在 哪里 


发 现 慢 在 哪里 


测试 方法 与 测试 场景 的 适用 关系 


i 


缺点 


1. 精度 低 ， 误 差 高 达 


0.5 秒 


2. 没 法 实现 自动 化 
1. 日 志 打 印 时 间 和 用 

户 感知 时 间 可 能 有 偏差 
2. 况 品 测试 不 方便 打 


印 日 志 


.分 析 视 频 操 作 烦 琐 
.实现 自动 化 难度 较 大 
分 析 经 扩 有 日 错 概 


纸 ， 需 要 人 村 校 验 


则 昌 一 


1. 需要 ROOT 手机 
2. 需要 Xposed 框架 


测试 结果 和 用 户 感 知 
可 能 存在 较 大 偏差 


度 测 试 的 五 种 场景 的 适用 关系 见 表 7-7。 


方法 启动 速度 。 | “操作 响应 速度 “| 网 页 打开 速度 F 载 速度 。 视频 打开 速度 
抬 表 计时 法 不 适用 不 适用 部 分 适用 部 分 适用 不 适用 
打印 日 志 计 时 法 部 分 适用 部 分 适用 部 分 适用 部 分 适用 部 分 适用 


图 像 分 析 计 时 法 


Hook 方案 计时 法 适用 
网 络 包 分 析 法 部 分 适用 部 分 适用 适用 


二 
天 
| 


部 分 适用 


7.3 手机 QQ 浏览 右 网 页 打开 速度 测试 实 匡 案例 


7.3.1 确定 关键 指标 


作为 一 球 工 具 类 的 App， 手 机 QQ 浏 哎 絮 将 简 涪 、 稳 定 和 快 作为 重 
点 保证 的 基础 能 力 。 而 浏 损 准 打 开 网 页 速度 的 快慢 则 是 用 户 评 价 浏览 
绥 快 慢 的 关键 场景 。 


但 用 什么 关键 指标 去 衡量 浏览 郁 打 开 网 页 的 快慢 ， 业 界 并 没有 统 
一 的 标准 。 手 机 QQ 浏 贤 融 测试 团队 茹 在 以 用 户 体验 为 中 心 的 角度 上 ， 
选 定 了 首 字 时 间 和 首 屏 时 间 两 个 关键 指标 。 


首 字 时 间 是 从 用 户 点 击 “ 进 入 ”按钮 到 手机 屏幕 页 面 出 现 第 一 个 文 
字 或 图 片 的 时 间 。 


首 屏 时 间 是 从 用 户 点 击 “ 进 入 ”按钮 到 手机 屏幕 页 面 铺 满 内 容 的 时 
间 。 


除了 选择 关键 指标 外 ， 还 要 选择 测试 的 网 络 类 型 、 测 试 站 点 、 是 
人 否 有 级 存 、 是 冷 局 动 还 是 热 局 动 等 。 由 于 这 些 因素 对 测试 方法 的 影响 
较 小 ， 在 这 里 束 不 深入 讨论 了 。 


7.3.2 ”过 择 测试 方法 


选 是 了 关键 指标 之 后 ， 再 选择 测试 方法 。 看 看 哪些 测试 方法 能 够 
度量 网 页 打开 速度 ， 哪 些 方法 能 够 定位 慢 在 哪里 。 针 对 当前 的 测试 目 
标 ， 我 们 对 测试 方法 做 了 以 下 几 方 面 分 析 。 


-打印 日 志 计时 法 : 网 页 打开 过 程 大 致 可 以 分 为 : 资源 请 求 一 解析 
一 排版 一 浑 染 一 上 屏 五 个 环节 ， 而 上 屏 环节 的 结束 时 间 程 序 自身 是 不 
知道 的 。 所 以 打印 日 志 计 时 法 无 法 准确 测量 用 户 感知 到 的 首 屏 时 间 。 
此 方法 只 能 作为 辅助 测试 方法 分 析 “ 慢 在 哪里 *。 (其 实 也 可 以 测试 一 
些 过 程 指标 耗 时 ， 监 控 版 本 间 的 性 能 变化 ) 


-图 像 分 析 计 时 法 : 此 方法 可 以 测量 用 户 感 知 的 首 屏 时 间 ， 但 实现 
目 动 化 有 相当 大 的 难度 ， 而 且 通 过 录 屏 方式 会 影响 手机 上 自身 性 能 (经 
验证 ， 首 屏 指标 会 相差 100~300ms， 而 且 不 同 竞 品 影响 程度 不 同 ) ， 只 
能 使 用 孙 像 方式 。 夯 外 ， 测 试 人 员 还 备 试 过 使 用 视频 采集 卡 的 方法 获 
取 录 制 手机 屏 人 幕 ， 但 最 终 因 视频 采集 卡 设备 兼容 性 较 差 而 放弃 。 有 录像 
方法 示意 图 如 图 7-15 所 示 。 


:Hook 方 案 计 时 法 : 通过 前 面 Hook 方 案 的 介绍 可 知 ，hook 方 案 适 
用 于 结束 帧 明确 的 测试 场景 。 而 网 页 打开 速度 测试 结束 帧 很 不 明确 。 
首 屏 出 现 后 ， 还 可 能 有 幻灯 片 滚动 ， 有 广告 弹出 ， 因 此 放弃 此 方法 。 


网络 包 分 析 法 :， 通 过 分 析 网 络 包 可 以 分 析 “ 慢 在 哪里 ”。 


综 上 所 述 ， 测 试 团队 选择 了 图 像 分 析 计 时 法 (主要 方法 ) + 打印 日 
志 计 时 法 (辅助 方法 ) + 网 络 包 分 析 法 (辅助 方法 作为 手机 QQ 浏览 
器 网 页 打开 速度 测试 的 方法 组 合 。 
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图 7-15 录像 方法 示意 图 


7.3.3 ”整体 方案 


选 定 测试 方法 后 ， 一 起 来 看 看 浏览 器 网 页 打开 速度 的 整体 方案 。 


如 匈 7-16 所 示 ， 在 手机 侧 ， 育 先 要 做 好 手机 环境 准备 ， 如 清除 缓 
存 、 打 开 被 测 场景 所 在 的 页 面 等 。 接 着 进行 真正 的 测试 动作 ， 比 如 打 
开 网 页 或 者 下 载 文件 等 。 在 进行 测试 动作 的 同时 要 打印 日 志 并 且 抓 取 
网 络 包 。 测 试 动作 完成 后 通过 adb 命 令 将 日 志文 件 和 网 络 包 复 制 到 PC 
端 。 最 后 需要 将 手机 环境 恢复 ， 比 如 退出 应 用 等 。 


手机 环境 准备 十 手机 测试 动作 十 手机 环境 恢复 


手机 侧 
打印 日 志 。 上。 


抓 取 网 络 包 “上 而 


村 大 ee 
-SS 日 志 分 析 此 


半 国 网络 包 分 析 具 
PC 侧 ,图 片 | 
摄像 头 录像 是 由 了 图 片 分 所 1 


图 7-16 浏览 右 网 页 打开 速度 的 整体 方案 


在 PC 侧 ， 需 要 对 手机 执行 测试 动作 的 全 过 程 进行 摄像 头 孙 像 ， 并 
将 视频 分 由 为 图 片 。 再 加 上 之 前 从 手机 侧 复 制 过 来 的 日 志文 件 和 网 络 
包 ，PC 侧 通过 对 应 的 分 析 算 法 束 能 分 析出 最 终 的 测试 结果 了 。 


整体 方案 中 的 名 词 解释 见 


表 7:=8 


名 词 
手机 环境 准备 
手机 测试 动作 
打印 日 志 


抓 取 网 络 包 


手机 环境 恢复 


表 7-8 。 


浏览 器 网 页 打开 速度 的 整体 方案 中 的 名 词 解释 
举例 (以 网 页 打开 速度 测试 为 例 ) 


执行 手机 测试 动作 之 前 的 准备 动作 | ”打开 浏览 需 ， 输 入 需要 访问 的 网 页 URL 

就 是 当前 要 测试 速度 的 动作 点 击 “前 往 ” 按 钮 及 等 待 网 页 打开 这 两 个 动作 

将 手机 测试 动作 过 程 的 日 志 完 整 打 | 保证 在 点 击 “ 前 往 ” 按 钮 前 开始 打印 日 志 ， 
印 出 来 网 页 打开 完成 后 才 停 止 

保证 在 点 击 “ 前 往 ” 按 钮 前 开始 抓 取 网 络 包 ， 在 等 
待 网 页 打开 完成 后 才 停止 

保证 在 点 击 “ 前 往 ” 按 钮 前 开始 录像 ， 在 等 待 网 页 
打开 完成 后 才 停 止 

删除 缓存 ， 关 闭 浏览 器 


在 等 待 


将 手机 测试 动作 过 程 的 网 络 包 完整 
抓 取 下 来 
将 手机 测试 动作 过 


程 完 束 ; 录制 F 来 


恢复 手机 环境 以 便 进行 下 一 次 测试 


7.3.4 解决 关键 问题 


测试 方法 选 定 之 后 ， 还 有 很 多 关键 问题 需要 解决 ， 包 括 如 何 选择 
摄像 天， 如 何 将 视频 分 帧 ， 如 何 挑选 关键 帆 ， 等 等 。 除 此 之 外 ， 还 要 
研究 如 何 利用 日 志和 网 络 包 定位 “ 慢 在 哪里 ”。 


1. 如 何 操 作 手 机 


手机 浏览 器 网 页 打开 速度 测试 的 操作 流程 包括 手机 环境 准备 、 手 
机 测试 动作 和 手机 环境 恢复 。 这 些 动作 归纳 起 来 就 是 点 击 、 滑 动 、 输 
入 URL、 等待 、 局 动 浏览 器 、 关 闭 浏 贤 右 等 。 测 试 团队 主要 使 用 adb 命 
令 和 sentevent 方 法 来 实现 这 些 动作 。 


先 介 绍 adb 命 令 。adb 是 Android 开 发 环境 目 融 的 工具 。 目 动 化 测试 
需要 的 操作 ， 使 用 adb 命 令 基本 都 能 完成 ， 常 用 adb 命 令 如 代码 清单 7-1 
所 示 。 

代码 清单 7-1 常用 adb 命 令 

adb install xxx.apk 安装 
apk 文 件 
adb shell am start -an com.xxx.xxx/.MainActivity 启动 


App 
adb shell] am force-stop com.XXX.XXxX 停止 该 


App 
adb shell input keyevent KEYCODE_HOME 模拟 


Android 的 


HOME 按键 


adb shel1 input text test_to_input 输入 文字 


adb Shel1 input tap x y 模拟 屏幕 


touch 操 作 


adb shell] input swipe X1 yl x2 y2 模拟 屏幕 滑动 操作 


adb devices 查看 所 有 在 线 的 


Android 设 备 


adb -s deviceID shell input tap x y 对 指定 


Android 设 备 模 拟 屏 幕 


touch 操 作 


大 家 经 常用 到 的 monkeyrunner 其 实 只 是 将 adb 操 作 封 装 了 一 下 而 
i 


接着 介绍 sentevent 方 法 。sentevent 方 法 说 起 来 也 是 adb 命 令 。 单 独 
把 它 列 出 来 说 的 原因 是 ， 它 具备 adb shell input 方 法 不 具备 的 能 力 : 模 
拟 屏幕 触 碰 事件 。 这 个 区 别 导 致 在 设置 了 “显示 触摸 操作 ”之 后 ， 使 用 
adb shell input 方 法 点 击 屏幕 不 会 产生 白 点 ， 而 使 用 sentevent 方 法 则 能 产 
生 白 点 。 前 文 提 到 过 ， 这 个 白 点 对 于 找 准 开始 帧 很 重要 ! 


sentevent 方 法 的 具体 用 法 : 


步骤 1: 使 用 手机 Shell 下 面 的 getevent 命 令 获 取 手 机 事件 。 以 按 
Power 键 为 例 ， 命 令 执行 结果 为 : 


C:\Users\abc>adb shell 
root@cancro:/ # getevent.... 


/dev/input/eventO: 0001 0074 00000001 
/dev/input/eventO: 0000 0000 00000000 
/dev/input/eventO: 0001 0074 O00000000 
/dev/input/eventO: 0000 0000 00000000 


以 第 一 条 为 例 分 析 一 下 获得 的 是 什么 。 


/dewinputevent0: 代表 按键 子 系统 ， 包 括 Home、Menu、Back 等 
按键 。 


.0001 代 表 一 个 type。 
.0074 代 表 Power 键 的 code (为 16 进 制 ) 。 
.00000001 代 表 value， 一 般 1 代 表 按 下 ，0 代 表 放 开 。 


据 查 阅 ，device、type、code、value 这 四 个 参数 正 是 sendevent 命 令 


需要 的 。 


人 @@ 提示 ”具体 关于 getevent 的 参数 可 以 使 用 geteventh 进 行 查看 ， 
也 可 以 参考 Google 提 供 的 文档 : 


http://source.android.com/devices/input/getevent.html 。 


天 于 这 些 event 的 常量 名 的 具体 意义 ， 可 以 参考 Google 的 男 一 个 很 
完整 的 文档 : http://source.android.com/devices/input/touch-devices.html 


O 


步 又 2: 通过 sendevent 命 令 模拟 手机 事件 。 下 面 四 条 命令 即 可 完成 
按 Power 键 的 操作 ， 中 间 sleep 的 时 间 长 度 大 于 2s， 系 统 束 认 为 是 长 按 ， 
代码 如 下 : 


sendevent /dev/input/Vevent9 1 116 1 
0074 转 化 为 十 进 制 后 为 


116) 


sendevent /dev/input/event0 0 0 0 
Sleep 3 

sendevent /dev/input/eventg9 1 116 0 
sendevent /dev/input/event0 0 0 0 


辐 注意 。 (1) 不 同 的 手机 的 硬件 中 断 触 发 事件 略 有 区 别 ， 可 以 
在 adb 下 使 用 getevent 进 行 测试 。 


(2) getevent 得 到 的 数值 是 16 进 制 的 ，sendevent 输 入 的 参数 是 十 进 
制 的 ， 注 意 进 行 转换 。 


(3) 如 果 依 然 没 有 效果 ， 党 试 先 修改 文件 权限 ， 执 行 su 命令 ， 再 
调用 chmod 777/dewinputevent[x] 。 


使 用 RootTools 库 执行 Linux 层 命令 ， 不 要 使 用 Runtime.getRuntime 


() .exec () 。 


sendevent 方 法 就 介绍 这 么 多 。 实 际 使 用 中 建议 将 sendevent 方 法 进 
行 封 装 后 再 使 用 ， 在 TMQ 官 网 可 以 下 载 笔者 封装 好 的 sendevent 人 代码 
(以 Nexus5 手 机 为 例 编写 ) 。 


以 上 介绍 的 两 种 方法 都 是 基于 坐标 的 目 动 化 测试 方法 。 测 试 团 队 
之 所 以 没有 用 UIAutomation 等 基于 控件 的 测试 方法 有 以 下 三 方面 的 原 
因 : 


-UIAutomation 等 基于 控件 的 测试 方法 对 于 某 些 控件 的 识别 能 力 不 
好 。 


-基于 控件 的 测试 方法 主要 是 解决 机 型 适 配 问 题 。 手 机 QQ 神 咒 絮 速 
度 测 试 使 用 的 机 型 相对 固定 。 


.速度 测试 的 操作 相对 简单 ， 适 配 一 个 新 机 型 工作 量 小 。 
2. 摄 像 工 具 选 择 


摄像 工具 主要 有 两 类 ， 普 通 摄像 头 和 手机 摄像 头 。 


而 测试 团队 选择 摄像 头 的 标准 是 : 成 像 质 量 蜗 、 帧 率 达 标 、 容 吻 
控制 、 稳 定性 好 。 不 同 摄像 头 对 比 见 表 7-9。 


综合 考虑 ， 测 弃 团 队 选 择 了 一 笋 普通 摄像 头 一 一 罗技 C920。 


普通 摄像 头 的 可 挖 性 是 它 的 软肋 。PC 上 的 驱动 和 摄像 头 客户 端 都 
能 从 罗技 官网 得 到 。 但 还 有 两 个 问题 官网 里 没有 答案 ， 需 要 上 自己 想 办 
法 解决 : 


表 7-9 不 同 摄像 头 对 比 
ET EE 


普通 摄像 头 拍摄 手机 屏幕 ， 对 摄像 头 | 30 帧 / 秒 需要 = PC 端 安装 驱动 以 | 因为 摄像 头 客户 端 
的 测 光 和 对 焦 能 要 求 比 较 及 摄像 头 客户 端 来 控制 摄像 | 对 PC 资源 消耗 较 大 ， 
高 。 市 面 上 500 元 以 上 的 摄 头 。 实 现 自 动 化 比较 麻烦 容易 造成 卡 死 。 在 部 
象 头 基本 能 满足 要 求 分 机 型 上 相对 稳定 
手机 摄像 头 拍摄 手机 屏幕 ， 对 摄像 头 | 30 帧 / 秒 使 用 adb 命令 控制 手机 摄 | 因 录 像 App 稳定 性 
的 测 光 和 对 焦 能 力 要 求 比 较 像 头 开 始 和 结束 录像 ， 操 作 | 而 异 

高 。 市 面 上 高 端 手机 基本 能 方便 。 但 需要 区 分 控制 录像 

满足 要 求 手机 和 被 测 手机 


问题 1 如何 招 摄 出 高 品质 的 录像 


拍摄 过 手机 的 读者 应 该 有 经 验 ， 要 拍 出 接近 采 屏 效果 的 手机 屏幕 
录像 其 实 很 难 ， 必 须 把 取景 、 对 焦 、 测 光 、 日 平衡 、 去 干扰 等 各 个 环 
方 都 处 理 好 了 才能 得 到 高 品质 的 录像 。 经 过 反复 的 探索 ， 测 试 团 队 终 
于 逐一 找到 了 解决 方案 。 


取景 : 使 用 翻拍 染 来 固定 手机 和 摄像 头 的 相对 位 置 ， 如 图 7-17 所 


修 ° 


图 7-17 ”屏幕 上 显示 触摸 位 置 


对 焦 ， 取 消 目 动 对 焦 ， 并 手动 对 焦 到 接近 清晰 ， 如 图 7-18 所 示 。 不 
要 调 到 最 清晰 ， 最 清晰 容易 产生 衍射 条 纹 。 


测 光 : 取消 目 动 济 光 。 手 动 调 广 合适 的 “上 曝光 ”和 “ 增 共 ”"， 如 图 7-19 
所 示 。 


日 平衡 : 保持 目 动 ， 保 证 画面 不 会 侦 监 或 者 俩 红 ， 如 岁 7-19 所 示 。 
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图 7-18 触摸 位 置 


Logitech HD Pro Webcam C920 
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图 7-19 屏幕 上 显示 触摸 位 置 


去 除 干 扰 : 用 一 个 纸箱 子 盖 住 摄像 头 和 手机 ， 去 除外 部 光照 干 
了 


经 过 以 上 步骤 后 ， 基 本 上 可 以 得 到 一 张 接近 录 屏 效果 的 录像 ， 如 
图 7-20 所 示 。 


图 7-20 ”罗技 C920 录 像 分 由 效果 
问题 2， 如何 用 脚本 控制 开始 录像 和 结束 录像 


因为 罗技 没有 提供 响应 的 接口 可 调用 ， 所 以 我 们 选择 了 屏幕 点 击 
的 方法 ， 就 是 获取 罗技 摄像 头 软件 Logitech Webcam Software 的 句柄 ， 
然后 按 相 对 坐标 点 击 开始 录制 按钮 ， 为 此 ， 测 试 组 专门 写 了 一 个 Exe 程 


序 CameraController.exe 〈 该 程序 收 永 于 可 下 载 的 源 文 件 中 ) 。Exe 程 序 
调用 方法 为 : 


时 


D:\abc>CameraController .exe start // 启 z 


Logitech Webcam Software 
D:\abc>CameraController .exe record // 开 始 或 结束 录制 


束 此 ， 开 始 邓 像 和 结束 孙 像 操作 得 以 解决 。 


3. 如 何 将 视频 分 帧 


视频 分 帆 的 工具 有 很 多 ， 测 试 团队 选择 的 依据 是 : 快速， 能 按 原 
蚌 率 分 帧 ， 分 帆 图 乒 不 失真 ， 分 帆 图 乒 太 才 小 ， 可 以 实现 目 动 化 。 


综合 以 上 因素 ， 测 试 团队 最 终 选 择 了 FFmpeg 这 个 第 三 方 工具 。 


@ 注音 ”关于 FFmpeg 的 介绍 和 工具 下 载 可 以 访问 以 下 两 个 网 
址 : 


工具 介绍 : http://baike.baidu.com/item/ffmpeg 。 
工具 下 载 : https://ffmpeg.org/ 。 
FFmpeg 的 使 用 方式 : 


ffmpeg-i videoFile-f image2-vf fps=fps=20 pngFiles 


参数 说 明 : 《更 多 参数 请 使 用 fftmpeg-h 命 令 查看 ) 
-ffmt force format 
-ifilename input file name 


-vframes number setthe number of video frames to record 


经 过 FFmpeg 工 具 分 帧 ， 视 频 被 转化 为 以 蝶 秒 时 间 命 名 的 图 片 集 。 
以 每 秒 20 帧 为 例 ， 第 一 张 图 片 命 名 为 0000.jpg， 第 二 张 图 乒 命 名 为 
0050.jpg， 第 三 张 图片 命 名 为 0100.jpg， 依 次 类 推 。 每 张 图 片 的 名 字 代 
表 的 数值 ， 就 是 这 个 图 片 与 视频 开始 帧 相隔 的 时 间 。 这 样 ， 找 到 开始 
帧 和 结束 帧 就 可 以 得 知 它们 出 现 的 时 间 了 。 


4. 如 何 找 准 开始 时 间 


前 面 介绍 过 ， 采 用 日 点 方法 可 以 辅助 找 准 开始 时 间 。 日 点 古 通 过 
系统 设置 -开发 者 选项 -~ 显示 触摸 操作 来 显示 〈 仅 Android 手 机 文 持 ) 
的 。 再 次 提醒 : 这 个 点 击 动作 要 用 sentevent 方 法 实现 ， 前 文 提 过 ， 用 这 
种 方法 才能 产生 白 点 。 效 果 如 图 7-21 所 示 。 左 、 右 截图 分 别 是 点 击 前 和 
点 击 后 的 效 末 。 
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图 7-21 屏幕 上 显示 触摸 位 置 


在 程序 中 ， 通 过 判断 图 片 中 的 第 一 张 白 点 出 现 的 时 间 ， 即 可 以 正 
确 确 定 进 入 的 时 间 。 目 前 采用 的 算法 是 : 判断 图 7-21 中 框框 内 白色 值 
(RGB 值 的 总 和 ， 框 框 需要 用 户 预先 定义 ) 相对 于 前 面 一 张 的 变化 
值 ， 变 化 值 达到 一 定 的 阔 值 ， 则 判断 为 白 点 出 现 ， 目 前 方法 较 简单 ， 

但 是 识别 率 高 ， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 白 点 识别 算法 


public boolean findwhitePoint(AppUI des, Rect localArea) { 
boolean isChanged = false; 
// 获取 第 一 张 图 片 的 


WhiteSize， 表 示 白 点 出 现 前 白 点 区 域 有 多 


If (0 == lastwhiteSize) { 
lastwhiteSize = des.getwWhitePositionSize(1LocalArea.X/ 
localArea.y,1localArea.width, localArea.height); 
return false,; 


// 获取 第 二 张 及 以 后 的 图 片 ， 与 前 一 张 对 比 看 白 点 区 域 有 没有 变 白 。 如 果 变 白 了 ， 则 表示 白 点 出 现 


else { 
int curSize = des.getwhitePositionSize(localArea.x, localArea.y, 
localArea.width, localArea.height); 
// 每 个 像素 白色 区 域 至 少 平均 变化 


6， 才 算是 出 现 白色 的 点 ， 这 里 是 一 个 经 验 阔 值 


If (Math.abs(curSize - lastwhiteSlize) > 6 * (localArea.width * 
localArea.height)) { 
isChanged = true; 
} else { 
isChanged = false; 
lastwhiteSize = curSize; 


} 


return isChanged; 


} 


5. 如 何 找 准 结束 时 间 一 一 首 字 时 间 


在 检测 到 日 点 出 现 后 ， 紧 接着 将 程序 切换 到 找 日 屏 的 状态 。 日 屏 
的 饱和 度 为 0， 当 日 屏 后 面 的 图 片 的 饱和 度 大 于 0 时 ， 代 表 首 字 出 现 ， 
如 图 7-22 所 示 。 左 图 尚未 出 现 目 子 ， 右 图 为 出 现 冯 字 的 第 一 张 图 片 。 


这 里 引入 了 一 个 新 的 概念 ， 饱和 度 。 


因为 前 文 介 绍 的 图 像 对 比 算法 找 结束 帧 有 一 个 明显 的 短 板 : 它 必 
须 先 指定 一 个 标准 图 片 。 而 对 于 首 字 时 间 这 个 指标 来 说 ， 标 准 图 片 是 


不 确定 的 ， 因 为 用 户 不 能 确定 一 个 网 页 是 会 移 显 示 文 字 还 是 先 显 示 图 
上 请。 因此 ， 这 里 需要 一 种 新 的 算法 来 找 标准 图 片 不 确定 的 结束 帧 。 饱 
和 度 算法 由 此 提出 。 


下 午 2:58 -i 下 年 2:58 


加 手机 腾讯 网 


@ 科 缉 创 k 手机 革 果 科学 电脑 


图 7-22” 首 字 图 片 


图 片 饱 和 度 算 法 : 将 分 帧 图 片 页 面 加 载 区 域 分 成 5x8 (例子 ) 个 格 
子 ， 记 为 totalj=40， 统 计 不 是 白色 的 格子 (颜色 的 复杂 度 大 于 某 个 冰 
值 ) 的 格子 个 数 ， 记 为 count， 饱 和 度 =count/total， 如 图 7-23 所 示 。 


图 7-23 ”图 片 饱 和 度 算 法 


代码 如 代码 清单 7-3 所 示 。 从 这 个 算法 的 说 明 中 可 以 看 出 ,不管 5 
面 什么 地 方 显示 出 内 容 ， 也 不 管 这 些 内 容 是 文字 还 是 图 乒 ， 它 都 能 第 
一 时 间 识 别 出 来 。 


代码 清单 7-3 ”获取 图 片 饱 和 度 算法 


public boolean[][] getComplexityStatus(Rect loadingArea) { 


boolean[][] res 


= null; 


if (loadingArea != null) { 


/ /指定 需要 分 析 


x 域 的 范围 


int x = loadingArea.x; 

int y = loadingArea.y; 

int width = LoadingArea.width 
int height = loadingArea.height; 


/ /指定 什么 叫 


色 ( 


因为 录像 出 来 的 白色 总 是 有 点 灰 


Color Curwhite = getwhite(loadingArea); 


// 70 像 素 


int row = 


个 格子 ， 看 屏幕 有 多 少 个 格子 


int column = 
res = new boolean[row][column]; 


// 将 需要 分 析 的 区 


height / PerformanceAnalyzer .getStepHeight() 


/ 
width / PerformanceAnalyzer .getSstepwidth(); 


域 分 成 多 份 


Rect[][] sub = new Rect[row][column]; 
int Subw = width / column; 

= height / row; 

for (int i = 0; i < column; i++) { 


int subH 


for (int j = 0; j < row; j++) { 
int xx = x + Subw * i; 
int yy = y + subH * j; 


sub[j][i] = new Rect(xx, yy, subw, subH); 


} 
} 


for (int i = 0; i < row; i++) { 
for (int j = 0; j < column; j++) { 
if (!res[i][j]) { 


5%， 则 认为 这 个 格子 已 经 显 


} 
} 


return res; 


示 内 容 


int xx = sub[i][j].x; 


int yy = sub[i][j].y; 
int ww = sub[i][j].width; 
int hh = sub[i][j].height; 


float p = 0.001f; 
// 计 算 当 前 格子 非 白 色 的 像素 点 的 比例 


p = this.getColorPercentage(CurWwhite, xx, yy, 
// 如 果 当 前 格子 非 白 色 的 像素 点 超过 


if (p > 0.05f) { 
res[i][j] = true; 


hh, ww, 140, 0); 


6. 如 何 找 准 结束 时 间 一 一 首 屏 时 间 


对 于 网 页 打开 速度 来 说 ， 结 束 时 间 就 是 首 屏 出 现 的 时 间 。 对 于 普 
通 的 网 页 ， 直 接 用 图 像 对 比 的 方法 就 能 找到 首 屏 。 


以 图 7-24 为 例 ， 选 取 视 频 分 帆 的 最 后 一 帧 为 标准 图 片 ( 首 屏 标 
准 ) 。 从 前 往 后 将 每 张 图 片 与 标准 图 片 对 比 ， 当 出 现 与 标准 图 片 一 致 
的 图 片 即 为 首 屏 (图 7-24 中 的 6 图 ) 。 


图 7-24 ”通过 标准 图 片 找 首 屏 


图 像 对 比 算法 或 者 工具 有 很 多 ， 测 试 团队 选择 的 标准 是 :准确 、 
快速 、 可 设置 灵敏 度 。 最 终 ， 测 试 团队 选 定 了 感知 哈 希 算法 。 


感知 哈 希 (hash) 算法 描述 了 一 个 有 可 比较 的 哈 希 函数 的 类 。 图 像 
特征 被 用 于 生成 独特 的 指纹 ， 这 个 指纹 相当 于 这 张 图 片 的 特征 参数 ， 


而 且 这 个 指纹 是 可 比较 的 。 如 果 hash 值 是 不 同 的 ， 则 数据 (图 片 内 容 ) 

也 是 不 同 的 ， 如 果 hash 值 是 相同 的 ， 则 数据 也 是 相似 的 。 (因为 可 能 存 
在 hash 冲 突 ， 相 同 的 hash 值 会 产生 不 同 的 数据 感知 哈 希 算法 是 目前 图 
片 搜 索 领 域 的 常见 算法 之 一 。 感 知 哈 布 特征 参数 的 提取 原理 如 图 7-25 所 


修 ° 


是 取 符 对 比 图 片 
的 hash 值 
计算 DCT 后 的 
数据 平均 值 
缩小 图 片 尺寸 


与 平均 值 对 比 ， 
简化 色彩 ， 灰 度 购 建 hash 值 
图 转换 


图 片 感知 hash 
值 提取 结束 


图 7-25 ”感知 哈 希 特征 参数 的 提取 原理 


识别 过 程 比较 简单 ， 通 过 对 比 竺 识别 图 片 和 标准 图 片 特征 参数 的 
相似 度 ( 汉 明 距离 ) 来 判断 图 片 是 否 相 同 ， 识 别 流程 如 图 7-26 所 示 。 


待 识别 图 片 


取 汉 明 距离 
diff 


Y 二 N 
图 片 匹配 成 功 匹配 失败 


图 7-26 图 片 搜索 识别 流程 


标准 图 片 


提取 hash 值 


到 这 里 ， 通 过 图 像 分 析 方 法 ， 已 经 得 到 测试 团队 最 初 选 定 的 两 个 
关键 指标 的 度量 值 一 一 首 字 时 间 和 首 屏 时 间 。 接 下 来 ， 看 如 何 通过 打 
印 日 志和 网 络 包 分 析 得 出 慢 在 哪里 。 


7. 当 网 页 市 有 幻灯 片 时 如 何 找 准 首 屏 


对 于 为 外 一 些 网 页 ， 打 开 后 会 有 大 图 幻灯 片 深 动 ， 如 图 7-27 所 示 ， 
这 种 情况 给 首 屏 的 找 准 带 来 了 新 的 困难 。 此 时 录像 的 最 后 一 帧 播放 的 
约 灯 乒 是 不 确定 的 ， 就 不 能 直接 用 它 作为 标准 图 片 了 。 
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图 7-27 有 大 图 筷 灯 片 深 动 的 网 页 


于 是 需要 引入 一 种 新 的 算法 : 标准 图 片 搜索 算法 。 


该 算法 的 逻辑 如 下 :从 最 后 一 张 图 片 开始 往 前 搜索 不 同 的 图 片 ， 
分 别 记录 为 标准 图 片 1、 标 准 图 片 2...... 标 准 图 片 N。 当 发 现 图 片 开 始 循 
环 时 ， 搜 索 算 法 结束 ， 于 是 就 产生 了 一 个 标准 图 片 集合 。 接 下 来 的 首 
屏 找 准 方法 跟 普 通 网 页 一 样 ， 只 是 标准 图 片 从 原来 的 一 张 变 成 了 多 
张 。 只 要 当前 图 片 和 标准 图 片 中 的 任意 一 张 相同 ， 即 被 识别 为 首 屏 。 


除了 大 图 幻灯 片 深 动 这 种 情况 外 ， 还 有 很 多 各 种 各 样 的 情况 会 给 
首 屏 找 准 市 来 困难 ， 比 如 广告 、 自 动 播放 的 视频 。 所 以 首 屏 算法 还 需 
要 留 最 后 一 手 :， 人 工 指定 首 屏 图 片 。 这 种 方法 需要 人 工 参与 ， 但 是 灵 


活性 比较 好 ， 适 合 应 对 其 他 算法 部 无 法 解决 的 特殊 情况 。 


8. 打 印 日 志 计 时 法 如 何 分 析 “ 慢 在 哪里 ” 


通过 打印 日 志 ， 可 以 得 知 程序 打开 网 页 的 每 个 过 程 的 耗 时 。 业 界 
也 有 TraceView、SystemTrace、Oprofile 等 性 能 优化 工具 。 但 对 于 浏览 
妖 这 种 特殊 形态 的 程序 ， 有 一 个 更 方便 的 日 志 形 式 来 获取 和 查看 这 些 
chrome trace 文 件 。 分 析 网 络 模块 的 性 能 都 可 以 用 到 这 个 日 志 


信息 / 忆 ， 


格式 。 


chrome trace 文 件 是 chrome 浏 宽 絮 目 市 的 用 于 打印 浏 贤 絮 每 个 线程 
的 工作 状态 的 文件 格式 。 打 印 的 内 容 需 要 开发 人 员 自 己 添加 ， 查 看 方 
式 则 是 通过 chrome 浏 贤 吉 访问 chrome: //tracing/ 查 看 ， 如 图 7-28 所 示 。 
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图 7-28 trace 文件 展示 图 


© 注意 ”trace 文 件 介绍 : 


https://www.chromium.org/developers/how-tos/trace-event-profiling-tool 


如 何 抓 取 trace 文 件 : https://www.chromium.org/developers/how- 


tos/trace-event-profiling-tool/recording-tracing-runs 


四 注意 因为 hace 不 是 本 节 介绍 的 重点 ， 所 以 这 里 点 到 为 止 ， 


不 再 展开 介绍 。 详 情 可 参考 chromium 官 网 www.chromium.org 。 


9. 网 络 包 分 析 法 如 何 分 析 “ 慢 在 哪里 ” 


从 浏览 器 网 页 打开 速度 的 整体 方案 图 7-15 中 可 以 看 到 ， 打 开 网 页 的 
时 候 会 全 程 抓 取 网 络 包 ， 人 然后 将 网 络 包 复制 到 PC 进行 分 析 。 前 文 也 已 
经 提 到 过 ，pcap 包 中 包含 的 信息 很 多 ， 需 要 提炼 出 一 些 关 键 的 指标 并 
将 它 目 动 化 分 析出 来 。 这 样 可 以 通过 这 些 指 标 快速 判断 一 次 测试 的 网 
络 包 有 没有 问题 。 如 琳 有 问题 ， 再 打开 网 络 包 看 详细 数据 。 最 终 ， 测 
试 团队 确定 的 关键 网 络 指标 是 : 流量 、 网 络 完成 时 间 和 主 资源 耗 时 。 


举 一 个 例子 说 明 网 络 包 是 怎么 辅助 定位 问题 的 。 有 一 次 笔者 测试 
赶集 网 的 一 个 页 面 ， 发 现 手 机 QQ 浏览 器 的 速度 比 系统 浏 虹 器 慢 很 多 。 
分 得 流量 和 网 络 完成 时 间 发 现 都 超过 了 系统 浏览 右 。 打 开 网 络 包 碍 
看 ， 发 现 手机 QQ 浏览 器 有 两 个 50K 以 上 的 大 资源 重复 请 求 了 ， 如 图 7- 
29 粗 框 处 所 示 ， 而 系统 浏览 右 则 不 会 重复 请 求 。 


= page 0 
习 POST datashare 200 OK mobds.ganji.cn 168B | 6ims 
出 GET g.js 200 0 sta.ganjistatic1.GC 3.2KB | 6ims 
习 GET version.js 200 OK sta.ganjistaticl.c 1.1KB WW 1.16s 
习 GET index.appcache 200 OK sta.ganji.com 252B 
1 sta.ganjistaticl.c¢ 100.2 K 
sta.ganjistaticl.G 660B 
sta.ganjistaticl.c¢ 55.5 KB 
习 GET zepto.cmb.js 200 OK sta.qanjistaticl.G 14.3 KB 


由 GET event.js 200 OK sta.ganjistaticl.c¢c 743B 
习 GET loading2.gif 200 OK sta.ganijistaticl.c¢ 9.1 KB 


9 GET version.js 304 Not Modified sta.ganjistaticl.c¢ 0 

由 GET redirecthtml 200 OK sta.ganjistaticl.GC 339B 

习 GET share.css 200 OK sta.ganjistaticl.c¢ 1.1 KB 

习 GET icon_guide.png 200 OK sta.ganjistaticl.c¢ 65.1 KB 

习 GET icon-status.png 200 OK sta.ganjistaticl.c¢ 100.2 K 

4 GET loading.gif 200 OK sta.qanjistaticl.GC 55.5 KB 977ms 


图 7-29 手机 QQ 浏览 硕 重 复 请 求 了 两 个 大 资源 


开发 人 员 进 一 步 定 位 问题 ， 发 现 该 问题 是 由 手机 QQ 浏览 器 的 云 加 
速 代 理 服 务 器 在 应 答 舍 有 If-modified-since 包 头 字 段 的 Get 请 求 时 处 理 不 


当 导 致 的 。 


关于 网 络 分 析 还 有 一 个 小 技巧 ， 束 是 可 以 在 点 击 go 打 开 网 页 的 同 
时 发 送 一 个 ping 网 络 包 ， 这 样 就 可 以 轻松 知道 在 网 络 包 里 是 什么 时 间 点 
击 go 的 了 。 这 对 于 分 析 主 资源 请 求 的 延 时 很 有 帮助 ! 如 图 7-30 所 示 ， 
ping 包 发 出 时 间 是 39.405267s， 主 资源 请 求 发 出 时 间 是 39.610197s。 两 
者 相差 205ms， 属 于 正常 范围 。 如 果 这 个 延 时 变 长 ， 就 需要 分 析 是 哪里 
出 现 了 问题 。 


0, ^ Time 
131| 39.405267 ICMP EN (ping) requesr id=0x0048， 3 12. tt1=64 
134 39.580907 10. 168. 204. 242 63.17 7.73.12 SPDY 60517 > http-alt [PSH，ACK] Seq=1 A n=13600 Len=40 
135 39. 581066_ 10.168.204.242 .177.73.12 SPDY SETTINGS MAX_! 让 STREAMS= 二 en AL_WINDOW_SIZE=10485760 


| 
145 39.764148 163.177.73.12 。 ,204.242 SPDY SYN_REPLY Stream=1 Response= 200 HTTP J 


图 7-30 ”利用 ping 包 计算 主 资源 延 时 


10. 对 测试 结 采 进行 数据 处 理 


因为 速度 测试 存在 网 络 波动 等 影响 因素 ， 测 试 结 采 会 有 误差 。 为 
了 将 误差 控制 在 可 以 接受 的 范围 内 ， 对 测试 的 数据 需要 做 以 下 处 理 : 


(1) 测试 足够 的 次 数 。 


(2) 去 除 异 常数 据 。 


(3) 取得 平均 值 。 


如 何 让 测量 值 尽 量 接近 被 测 值 是 一 门 很 高 深 的 学 问 。 在 这 方面 我 
们 做 的 研究 和 答 试 比较 有 限 ， 这 里 只 分 享 个 人 觉得 最 有 参考 意义 的 一 
些 发 现 : 


(1) 网 页 打开 速度 的 数据 点 并 非 如 很 多 人 想象 的 那样 成 正 态 分 
布 ， 而 是 成 对 数 正 态 分 布 。 


(2) 数据 处 理 算法 的 科学 严谨 性 和 可 操作 性 之 间 需 要 取得 一 个 平 


关于 (2) ， 我 们 有 过 失败 教训 。 最 初 我 们 用 正 态 分 布 的 模型 求 测 
试 数据 的 期 望 值 ， 后 来 发 现 这 种 方式 算法 太 复 洒 ， 也 不 容易 发 现 和 定 
位 问题 ， 束 改 用 了 切 尾 均值 〈 指 在 一 个 数列 中 ， 去 掉 两 端的 极端 值 后 
所 计算 的 算术 平均 数 ) 。 


11. 如 何 展示 测试 结果 


为 了 方便 碍 看 结果 ， 开 始 时 间 、 结 束 时 间 以 及 网 络 包 分 析 等 测试 
结 采 保存 在 本 地 的 同时 会 上 传 到 服务 句 展 示 。 原 始 数 据 经 过 一 定 的 数 
据 处 理 剔 除 异 常数 据 后 取 平 均值 生成 最 终结 果 ， 如 图 7-31 和 图 7-32 所 
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图 7-31 详细 数据 
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图 7-32 “平均 值 汇 总 数据 
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7.3.5 ”速度 优化 效果 
手机 QQ 浏览 器 网 页 打开 速度 测试 这 套 技 术 方案 ， 测 试 团队 根据 不 
同 的 目的 制定 了 四 种 不 同 的 测试 类 型 ， 见 表 7-10 。 


表 7-10 ”网 页 打开 速度 测试 四 种 不 同 的 测试 类 型 
测试 类 型 测试 周期 测试 效果 


Dailybuild 版 本 测试 及 时 发 现 每 天 构建 版 本 有 没有 性 1 赤 监控 2 年 ， 发 现 5 次 明显 性 能 
能 倒退 倒退 ，20 次 小 幅 性 能 倒退 
上 线 前 性 能 测试 衡量 版 本 网 页 打开 速度 是 否 达 到 | 1 个 版 本 测试 2 年 共 20 个 版 本 ,2 次 发 


发 布 标准 现 版 本 不 符合 发 布 标准 


Top 站 点 测试 发 现 手 机 QQ 浏览 器 相对 竞 品 慢 | 1 个 月 每 月 发 现 3 ~ 5 个 相对 竞 品 落 
的 站 点 ， 以 便 针 对 性 优化 后 的 站 点 
优化 版 本 测试 对 比 新 旧版 本 ， 验 证 开发 的 速度 | 不 定时 帮助 开发 验证 30 个 优化 点 的 有 
优化 代码 提交 后 是 否 有 效 效 性 
-脚本 运行 效率 : 一 部 手机 每 天 晚上 可 以 测试 三 个 站 点 与 竞 品 对 比 
(每 个 站 点 测试 20 次 ) 。 


:人力 投入 : 每 次 测试 (一 部 手机 测试 三 个 站 点 与 况 品 对 比 ) 需 
投入 0.5~1 天 的 人 力 ， 包 括 测试 前 的 准备 和 测试 后 的 校 验 审查 。 


7.4 手机 QQ 济 锅 旭 多 窗口 按钮 速度 实践 条 例 


上 一 节 讲 解 了 手机 QQ 浏览 器 网 页 打开 速度 测试 ， 本 节 以 手机 QQ 
浏览 器 功能 类 多 窗口 按钮 速度 测试 为 例 ， 详 细 讲 解 功能 类 速度 测试 如 
何 开展 。 


7.4.1 为 什么 要 做 多 窗口 按钮 速度 测试 


多 窗口 按钮 足 实现 浏览 页 面 之 间 相 互 切换 的 功能 按钮 ， 浏 蜗 功 能 
征用 户 的 核心 诉求 ， 手 机 QQ 浏览 夯 提 供 多 个 页 面 浏览 功能 ， 使 我 们 可 
以 打开 多 个 窗口 ， 每 个 窗口 浏 哆 一 个 页 面 ， 看 完 一 个 页 面 ， 切 换 到 田 
一 个 页 面 继续 浏览 ， 提 高 浏 咒 的 顺畅 性 。 多 窗口 按钮 是 通 往 页 面 切 换 
的 必 经 路 径 ， 从 数据 上 看 ， 用 户 使 用 多 窗口 实现 切换 页 面 浏 蜗 非 第 频 
繁 ， 故 我 们 对 这 类 用 户 使 用 频繁 的 按钮 进行 相应 的 速度 测试 。 男 外 从 
用 户 的 习惯 和 数据 统计 看 ， 用 户 使 用 三 个 窗口 的 情况 比较 多 ， 故 我 们 
在 挑选 窗口 数 时 ， 选 择 了 三 个 窗口 。 


7.4.2 什么 是 多 窗口 按钮 速度 测试 
图 7-33 中 左边 图 为 浏览 三 个 页 面 图 ， 其 中 框 线 中 为 多 窗口 按钮 ， 右 
边 图 为 点 击 多 窗口 按钮 后 多 窗口 界面 图 ， 而 我 们 要 测试 的 多 窗口 按钮 


速度 ， 指 的 就 是 从 点 击 多 窗口 按钮 到 右边 界面 图 显示 出 来 的 时 间 。 
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在 这 里 我 们 可 思考 一 下 ， 为 什么 是 速度 测试 ， 而 不 是 内 存 或 者 流 
畅 度 等 测试 呢 ? 我 们 是 这 么 思考 的 ， 用 户 点 击 多 窗口 按钮 ， 目 的 是 什 
么 呢 ? 当然 不 是 打开 多 窗口 界面 ， 而 是 切换 浏览 页 面 ， 那 么 用 户 在 这 
个 位 置 最 期 望 什么 呢 ? 是 以 最 快 的 速度 切换 到 自己 想 要 浏览 的 页 面 ， 
故 该 位 置 速度 就 成 为 非常 重要 的 指标 ， 所 以 我 们 对 浏览 器 多 窗口 按 包 
进行 了 速度 测试 


7.4.3 ”多 窗口 按钮 速度 测试 影响 因素 和 测试 方法 


做 多 窗口 按钮 速度 测试 之 前 ， 我 们 需要 分 析 一 下 ， 对 于 多 窗口 按 
钮 速度 测试 来 讲 ， 有 哪些 因素 会 影响 到 多 窗口 按钮 速度 测试 ， 这 里 列 
举 一 下 会 产生 影响 的 因素 : 


手机 : 不管 是 目 喘 版 本 对 比 还 是 跟 范 品 对 比 ， 建 议 为 同一 部 手机 
和 同样 的 环境 ， 以 保证 对 比 的 可 靠 性 。 如 采 不 是 同一 部 手机 ， 手 机 性 
能 不 同 ， 则 导致 无 可 比 性 。 


网络: 我 们 是 三 个 窗口 《最 常见 的 用 户 打开 的 窗口 数 ) ， 三 个 窗 
口 是 网 页 ， 必 须 确保 网 络 已 经 拉 取 完成 。 因 为 如 采 有 网 络 未 拉 取 完 
成 ， 那 么 在 点 击 多 窗口 按钮 和 时， 就 可 能 存在 义 拉 取 网 页 、 又 打开 多 窗 
口 按钮 的 现象 ， 事 件 并 发 执行 ， 对 资源 的 消耗 不 一 致 的 ， 故 我 们 在 
测 弃 三 个 多 寡 口 时 ， 都 是 保证 网 页 拉 取 完成 ， 同 时 在 目 身 和 版 本 做 对 比 
或 者 跟 范 品 做 对 比 时 ， 痢 需要 保证 网 页 一 致 。 


` 运 行 的 程序 ， 保证 其 他 App 也 是 一 致 的 情况 ， 手 机 的 资源 是 一 定 
的 。 如 果 有 其 他 App 在 耗 用 人 资源， 那么 被 测 对 象 束 可 能 受到 影响 。 这 
里 有 个 真实 的 案例 ， 之 前 我 们 在 测试 时 ， 有 其 他 App 一 直 在 后 全 运 
行 ， 寻 致 我 们 多 轮 数 据 非 党 不 稳定 ， 最 后 查找 原因 为 其 他 App 的 影 
啊 。 


-样本 : 为 了 保证 得 到 的 数据 是 正确 的 ， 建 议 测试 多 轮 ， 这 样 不 仅 
可 以 看 到 多 轮 数 据 是 否 稳 定 ， 排 除 其 他 影响 ， 而 且 也 能 看 到 多 轮 趋 
势 。 相 对 来 讲 ， 采 用 样本 越 多 ， 越 能 得 出 精准 数据 。 


当 我 们 排除 影响 因素 后 ， 束 可 以 开始 做 多 窗口 按钮 速度 测试 了 ， 
首先 对 于 之 前 介绍 的 速度 测试 方法 ， 我 们 来 看 看 移 择 什么 样 的 测试 方 
法 ， 能 快速 、 高 效 地 获取 准确 数据 。 因 我 们 做 的 是 多 窗口 按钮 速度 测 
试 ， 之 前 所 到 了 几 种 测 斌 方法， 我 们 逐一 来 衡量 ， 看 哪 种 更 适合 多 窗 
口 按钮 速度 测试 。 


牛 表 计时 法 : ”新 窗口 打开 速度 低 于 1s， 采 用 该 方法 准确 度 无 法 保 
隐 ， 故 未 采用 。 


打印 日 志 计时 法 : 该 方法 对 于 目 身 产品 是 可 用 的 ， 但 是 如 有 果 要 跟 
苋 品 对 比 ， 殊 无 法 达到 ， 而 多 窗口 打开 速度 需要 和 竞 品 对 比 ， 故 也 不 
采用 这 种 方法 。 


图 像 分 析 计 时 法 该 方法 能 满足 需求 ， 但 只 是 一 个 具体 的 时 间 ， 
而 对 于 多 窗口 打开 速度 而 言 ， 我 们 不 仅仅 和 希望 得 到 总 体 数 据 ， 还 希望 
得 到 详细 数据 ， 如 哪里 慢 了 ， 是 什么 原因 导致 的 慢 ， 故 该 方法 也 未 采 
用 。 


Hook 方案 计时 法 : 本 次 多 窗口 打开 速度 我 们 选用 这 种 方法 ， 因 
这 种 方法 能 知道 每 个 View 的 时 间 ， 以 此 来 找到 导致 慢 的 原因 。 


综 上 所 述 ， 在 多 窗口 按钮 速度 测试 案例 上 我 们 采用 了 Hook 方 案 计 
时 法 。 


7.4.4 如 何 进行 多 窗口 按钮 速度 测试 


对 于 多 窗口 按钮 速度 测试 ， 我 们 先 思考 一 下 整个 过 程 ， 然 后 从 整 
个 过 程 中 ， 看 看 我 们 可 以 获得 哪些 数据 。 点 击 多 窗口 按钮 ， 弹 出 多 窗 
口 界面 ， 这 个 是 直观 的 感受 ， 也 是 我 们 需要 获得 的 时 间 ， 但 是 整个 过 
程 具体 在 做 什么 呢 ? 从 技术 角度 来 讲 ， 首 先是 多 窗口 按钮 被 点 击 ， 触 
发 相应 事件 ， 然 后 进行 多 窗口 界面 View 等 的 绘制 ， 当 多 窗口 界面 所 有 
View 绘 制 完 成 后 ， 多 窗口 界面 就 显示 出 来 。 从 以 上 分 析 可 知 ， 从 点 击 
多 窗口 按钮 到 所 有 View 的 绘制 完成 时 间 就 是 多 窗口 按钮 的 打开 速度 ， 
这 里 View 的 绘制 快慢 决定 了 打开 速度 的 快慢 ， 我 们 通过 hook (请 参考 
7.2.4hook 方 案 计 时 法 ) 方法 ， 在 浏览 器 中 打开 三 个 窗口 ， 等 待 每 个 窗 
口中 的 页 面 拉 取 完成 ， 然 后 点 击 多 窗口 按钮 直到 所 有 View 绘 制 完 成 为 
止 ， 整 个 操作 对 应 的 信息 会 输出 到 Logcat 日 志 中 ， 获 取 相 应 View 的 绘制 
时 间 详 情 如 下 : 


1. 获 取 总 时 间 以 及 各 个 View 绘 制 时 间 (View 的 onDraw 的 时 间 总 
和 ) 


通过 hook 方 案 中 的 Logcat 日 志 ， 找 到 总 时 间 ， 通 过 查找 
MethodHook 关 键 字 ， 得 到 所 有 关于 该 关键 字 的 信息 如 图 7-34 所 示 ， 其 
中 最 后 一 行 “[dlick]null cost: 689” 束 是 多 窗口 打开 总 时 间 。 
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示 ， 其 中 第 三 行 “cost: 
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图 7-34 
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[click] null cost: 


响 速 度 最 大 的 View， 我 们 又 通 


[0,60] [1080,1920] cost 31 
[0,1776] [1080,1920] cost 44 
[0,1776] [1080,1920] cost 56 
[0,1776] [1080,1920] cost 77 
[0,601 [1080,1920] cost 100 
[0,1776] [1080,1920] cost 111 
[0,1776] [1080,1920] cost 123 
[0,0] [1080,1920] cost 387 
[0,0] [1080,1920] cost 397 
[0,0] [1080,1920] cost 418 
[0,0] [1080,1920] cost 424 
[0,0] [1080,1920] cost 439 
[0,0] [1080,1920] cost 455 
[0,0] [1080,1920] cost 473 
[0,0] [1080,1920] cost 493 
[0,0] [1080,1920] cost 511 
[0,0] [1080,1920] cost 531 
[0,0] [1080,1920] cost 550 
[0,0] [1080,1920] cost 566 
[0,0] [1080,1920] cost 577 
[25, 695] {1055,1920] cost 600 
[0,0] [1080,1920] cost 616 
[0,0] [1080,1920] cost 639 
[0,0] [1080,1920] cost 667 
[0,236] [1080,1920] cost 673 
[84,768] [126,809] cost 689 
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多 窗口 打开 总 时 间 


过 hook 方 案 中 的 Logcat 日 


这 样 的 方式 获取 : 如 获取 
查找 17367429， 获 得 的 信息 如 图 7-35 所 


[frame] [17 
[frame] [2 


[frame] [317 


5” 就 是 指 该 View 的 时 间 为 5ms 。 


: D/MethodHook (11261): 


图 7-35 “View17367429 耗 时 图 


为 了 能 比较 清晰 地 知道 View 耗 时 对 比 ， 我 们 将 每 个 View 耗 时 图 形 
化 ， 图 7-36 所 示 为 两 个 版 本 的 View 耗 时 对 比 图 ， 从 图 中 比较 容易 看 出 
View 耗 时 对 比 ， 也 容易 找到 耗 时 多 的 View， 以 供 开发 人 员 优化 。 
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图 7-36 ”QB6.4 VS QB6.3 多 窗口 View 绘 制 时 间 (ms) 


获得 各 个 View 的 时 间 后 ， 我 们 可 找 出 哪个 View 耗 时 最 多 ， 哪 个 
View 应 该 优化 。 比 如 图 7-36 中 ， 可 以 看 到 耗 时 最 多 的 View 是 
QBToolbar#67， 进 而 在 6.4 版 本 中 针对 耗 时 多 的 View 进 行 优化 。 另 外 从 
View 绘 制 机 制 中 了 解 到 ， 绘 制 时 间 还 会 跟 过 度 绘制 倍数 有 一 定 的 关 
系 ， 下 面 我 们 看 看 如 何 获得 UI 过 度 绘 制 (UI 过 度 绘 制 简单 说 就 是 指 在 
一 个 界面 中 有 很 多 元 素 ， 当 只 需要 更 新 某 一 小 块 的 元 素 时 ，App 却 把 所 
有 的 元 素 都 刷新 一 遍 ， 这 就 会 造成 过 度 绘制 ) 。 


2. 获 得 UI 过 度 绘制 倍数 


通过 Hook 方 案 中 的 Logcat 日 志 ， 查 找 overdraw 来 获得 UI 过 度 绘制 倍 
数 overdraw: 1.2942646， 这 样 代 表 过 度 绘制 倍数 为 1.2942646。 过 度 绘 
制 倍数 越 高 ， 绘 制 速度 越 慢 ， 故 可 通过 减少 过 度 绘制 倍数 来 提升 速 
度 。 以 浏览 器 两 个 版 本 为 例 ， 之 前 过 度 绘制 为 2.69， 优 化 后 ， 过 度 绘制 
为 1.29。View 绘 制 时 间 和 是 否 存在 过 度 绘 制 都 是 影响 速度 的 重要 因素 ， 
除 此 之 外 ，UI 布 局 也 非常 重要 ， 下 面 我 们 再 来 看 看 布局 是 否 合 


3.UI 布 局 是 否 合理 


通过 Hierarchy Viewer (使 用 方法 可 参考 网 络 ) 观察 UI Tree 的 深度 
和 View 总 数 ， 来 衡量 UI 布 局 是 人 否 合 


在 旧版 本 中 ， 我 们 通过 观 聚 多 窗口 Hierarchy 树 形 结构 ， 打 开 新 
浪 、 腾 讯 、 搜 狐 三 个 窗口 ， 发 现 View 22 个 ，Tree 深 度 为 6 级 ， 而 深度 对 
于 温 染 是 非常 关键 的 点 ， 深 度 越 深 ， 泻 染 越 慢 ， 故 提出 需要 优化 Tree 的 
深度 。 经 过 开发 优化 ， 新 的 版 本 中 同样 的 情况 多 窗口 有 26 View，Tree 
深度 为 5 级 ， 然 而 渲染 的 总 时 间 减 少 了 ， 优 化 有 了 一 定 的 效果 。 上 面 是 
从 绘制 角度 和 布局 角度 来 深度 分 析 多 窗口 按钮 速度 耗 时 点 ， 下 面 我 们 
可 以 再 深入 一 些 ， 做 到 函数 时 间 。 


4. 团 数 Trace 时 间 


通过 记录 Trace 〈 使 用 方法 可 参考 网 络 ) ， 查 看 排名 TOP 的 函数 ， 
为 开发 人 员 提供 重点 优化 的 关键 点 ， 如 图 7-37 所 示 。 


Name Incl Cpu Time % 
有 27ECIVIENEENVIVEIOWSEUTUIWTIOWAIEWRIWindOWNEWOURIESSUIE GDV 
中 28 android/view/ViewGroup.dispatchDraw (Landroid/graphics/Canvas;)V 
目 29 android/view/ViewGroup.drawChild (Landroid/graphics/Canvas;Landroid/view/View;))Z 
@30 android/view/View.draw (Landroid/graphics/Canvas;Landroid/view/ViewGroup;))Z 


31 bdo htm ilmenite seem ee SE 
OQ OU (| OQ S DD 


aDisplayList (Lana 
33 android/view/View.getDisplayList SI 
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图 7-37 Trace 图 


总 结 : 通过 四 个 方面 比较 详细 的 数据 分 析 ， 经 过 优化 ， 多 窗口 在 
新 版 本 中 的 打开 时 间 从 原来 的 864ms 减 少 到 468ms， 缩 短 45.8%。 如 果 
想 让 测试 对 于 关键 点 能 起 到 正 向 引导 开发 优化 的 良好 作用 ， 测 试 应 该 
不 仅仅 提供 数据 ， 还 应 该 对 于 总 体 数 据 进 行 详 细 的 分 机 ， 提 供 比 较 全 
面 的 分 析 来 正 向 指导 开发 优化 ， 以 此 来 提升 产品 口碑 和 测试 口碑 。 


7.5 本章 小 结 


本 章 介 绍 了 速度 测试 常用 的 几 种 测试 方法 ， 并 以 两 个 案例 详细 讲 
述 了 图 像 分 析 计 时 法 和 Hook 方 案 计 时 法 在 手机 浏 贤 右 项 目 中 的 实践 过 
程 及 效果 。 测 试 方法 的 选择 应 该 因地制宜 ， 不 应 该 一 味 追 求 高 级 技术 
方案 。 但 无 论 使 用 什么 测 斌 方法， 速度 测试 的 开展 都 应 该 按照 “测试 场 
景 选 择 -~ 测试 方法 选择 -测试 方案 实现 ”的 步骤 依次 进行 。 通 过 对 指定 
场景 的 速度 度量 和 发 现 “ 慢 在 哪里 "， 最 终 帮 助 研 发 团队 优化 产品 性 
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第 8 章 ”视频 性 能 测试 案例 


本 章 通过 浏览 器 视频 性 能 测试 案例 ， 详 细 讲 解 和 剖析 视频 播放 首 
帧 响应 时 间 测 试 方案 以 及 实现 原理 ， 它 不 是 其 他 章节 所 述 的 框架 的 直 
接应 用 ， 而 是 自动 化 测试 的 工具 改造 及 应 用 的 代表 案例 。 读 者 阅读 本 
章 需 要 一 定 的 编程 基础 ， 主 要 包括 Android SDK 和 NDK 基 础 编程 、 
OPENCV 图 形 识别 和 相似 度 对 比 技术 、FFMPEG 视 频 解 码 技术 以 及 Java 
和 Javascript 之 间 通 信 的 相关 知识 。 同 时 ， 本 章 的 工具 开发 涉及 代码 也 
比较 多 ， 建 议 读者 在 学 习 本 章 内 容 时 ， 下 载 相应 的 代码 多 加 实践 ， 以 
理解 其 中 的 精华 。 为 使 读者 更 好 地 阅读 本 章 ， 我 们 整理 了 本 章 知识 
点 ， 如 图 8-1 所 示 。 


需求 分 析 
[设计 晴 族 二 重 直 个 沉 损 
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图 8-1 本 章 知 识 结构 图 


8.1 视频 性 能 测试 需求 分 析 


随 着 移动 终端 的 快速 发 展 ， 通 过 手机 观看 视频 已 经 成 为 大 众 所 喜 
爱 的 一 种 休闲 方式 。 当 前 市 场 上 视频 播放 器 App 品 种 众多 〈 包 括 优酷 、 
乐 视 、 搜 索 、 有 过 奇 忆 客户 端 、 MX Player、 短 风 影 音 以 及 各 种 浏览 套 
等 ) ， 功 能 越 来 越 丰 富 ， 界 面 也 越 来 越 人 性 化 。 但 我 们 依然 无 法 回避 
手机 本 身 硬件 和 软件 存在 差异 的 客观 现实 ， 这 就 造成 了 不 同 的 手机 在 
运行 视频 播放 器 程序 时 有 快 有 慢 。 在 实际 播放 器 项 目测 试 中 梳理 ， 影 
啊 视 频 播放 体验 的 因 系 最 终 通 过 以 下 儿 个 性 能 指标 来 体现 ， 如 图 8-2 所 
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首 帧 啊 应 时 间 
拖 动 啊 应 时 间 


响应 时 间 


CPU 指标 


= 视频 播放 质量 播放 稳定 性 
内 存 指 标 


播放 流畅 度 


图 8-2 ”衡量 视频 播放 天 的 相关 指标 


对 于 上 图 中 所 示 各 项 ， 分 析 如 下 : 


首 帧 啊 应 时 间 :” 即 用 户 首次 加 载 视频 ， 获 取 首 个 完整 关键 帧 所 需 
的 上 时长， 通俗 的 理解 就 是 从 用 户 点 击 播放 按钮 到 出 现 第 一 帧 视频 画面 
所 需要 的 时 间 。 关 于 这 个 指标 详细 的 解释 请 读者 参考 8.2 订 。 


- 拖 动 啊 应 时 间 :， 即 用 户 拖 动 进度 条 到 指定 位 置 后 ， 出 现 指定 位 置 
的 第 一 帧 视频 所 需要 的 时 间 。 例 如 当前 播放 器 在 1 分 30 秒 ， 拖 动 进度 条 
到 10 分 钟 位 置 后 到 出 现 第 10 分 钟 的 视频 首 帧 画面 所 需要 的 时 间 台 是 
Seek 到 10 分 钟 位 置 的 啊 应 时 间 。 


:播放 流畅 度 : 即 视频 播放 过 程 1 秒 钟 时 间 里 显示 的 图 片 的 帧 数 ， 
也 可 以 理解 为 图 形 处 理 融 每 秒 钟 能 够 刷新 几 次 。 帧 率 越 大 ， 画 面 越 流 
畅 ， 帧 率 越 小 ， 画 面 越 有 跳动 感 。 现 在 市 场 主流 的 视频 帧 率 是 15 帧 / 
秒 ， 超 清和 监 光 视频 写 25 帧 / 秒 。 


-播放 成 功率 :， 即 成 功 播放 视频 数 占 总 共 播 放 视 频 总 数 的 比例 。 这 
个 指标 在 网 络 视频 播放 器 衡量 中 〈 包 括 点 播 和 直播 ) 尤其 重要 ， 也 是 
衡量 播放 需 好 坏 的 一 个 非常 重要 的 指标 。 考 虑 到 测试 的 片 源 数量 有 
限 ， 为 了 更 加 准确 地 反映 这 个 指标 的 有 效 性 ， 所 以 通过 后 台 上 报 来 统 
计 播 放 成 功率 。 例 如 播放 失败 片 源 数 为 1 万 ， 总 播放 片 源 数 为 100 万 ， 
那么 播放 成 功率 即 为 (100-1) /100x1009%6=999%6。 


-续航 能 力 : 即 在 手机 满 电 的 情况 下 ， 持 续 播 放 视 频 待 机 时 长 。 待 
机 时 间 越 长 越 好 。 


CPU 指标 : 即 视频 播放 右 在 局 动 和 播放 视频 过 程 中 ，CPU 所 占用 
的 情况 。 如 果 CPU 占 用 过 高 ， 就 会 出 现 手 机 发 次 、 续 航 能 力 降低 的 现 
象 。 


-内存 指标 : 即 视频 播放 句 在 启动 和 播放 视频 过 程 中 ， 内 存 所 占用 
的 情况 。 一 般 内 存 占 用 越 低 越 好 。 


-播放 稳定 性 : 视频 在 播放 过 程 中 ， 不 会 因为 播放 时 间 长 而 导致 视 
频 播 放 质 量 的 下 降 ， 主 要 包括 音 视 频 同步 、 画 面 的 质量 、 流 畅 度 、 响 
应 时 间 等 指标 。 


上 述 指标 ， 引 在 通过 对 不 同 的 手机 终端 进行 性 能 上 的 考察 ， 增 加 
性 能 区 分 维度 ， 为 视频 播放 器 测试 提供 技术 保障 ， 从 而 满足 用 户 的 需 
求 。 从 这 些 指标 上 看 ， 视 频 衣 帧 啊 应 时 间 尤 其 重要 。 因 为 对 于 用 户 来 
说 ， 播 放 祝 频 最 和 体验 到 的 性 能 指标 残 是 视频 播放 的 首 帧 啊 应 时 间 ， 
它 的 快慢 直接 关系 到 用 户 对 于 产品 的 第 一 印象 。 所 以 本 章 在 涉及 的 视 
频 性 能 指标 中 ， 以 QQ 浏览 器 中 视频 播放 器 为 例 ， 和 读者 一 起 分 至 浏览 
大 中 视频 播放 首 帧 啊 应 时 间 的 测试 方案 。 


8.2 ”视频 下 帧 性 能 测 弃 方 案 的 设计 思路 


8.2.1 视频 播放 流程 


相信 大 部 分 读者 都 用 手机 端的 浏览 器 观看 过 视频 ， 笔 者 在 这 里 和 
读者 一 起 了 解 一 下 用 户 浏 览 器 播放 视频 的 基本 流程 。 


(1) 打开 浏览 器 ， 在 视频 地 址 栏 中 输入 视频 的 URL 地 址 ， 如 图 8-3 
A 


《人 @ 浪漫 天 降 一 在 线 播放 一 《浪漫 天 降 》 一 电 … 视 频 地 址 栏 


Q 2 9 
搜索 ”登录 ”记录 


图 8-3 ”浏览 絮 打 开 视 频 网 页 页 面 


(2) 点 击 视频 页 面 中 的 播放 按钮 ， 浏 贤 圳 解析 页 面 ， 获 取 到 当前 
视频 的 真实 片 源 地 址 后 ， 播 放 器 请 求 下 载 当前 视频 源 ， 所 以 从 用 户 的 
角度 可 以 看 到 如 下 的 屏幕 ， 如 图 8-4 所 示 。 


图 8-4 正在 加 载 视频 


(3) 下 载 到 一 定 大 小 的 视频 源 后 ， 播 放 器 解码 器 进行 解码 ， 再 通 
过 手机 屏幕 显示 出 首 帧 画面 ， 如 图 8-5 所 示 。 


《看 后 看 传 说 TV 全 第 24 集 


图 8-5 出现 视频 首 帧 画面 


在 上 述 浏览 句 视 频 播放 基本 流程 中 ， 从 点 击 播放 按钮 到 出 现 视 频 
的 首 帧 画面 所 需要 的 时 间 就 是 前 面 所 说 的 性 能 指标 的 首 帧 啊 应 时 间 。 


8.2.2 ”设计 思路 


前 面 通过 播放 流程 的 方式 介绍 了 视频 首 帆 响应 时 间 的 概念 ， 那 么 
征 如 何 计算 啊 应 时 间 的 呢 ? 从 播放 流程 可 以 清楚 地 知道 ， 只 要 确定 开 
始 时 间 (也 就 是 点 击 播放 按钮 的 时 间 ) 和 结束 时 间 (也 就 是 出 现 视 频 
陡 帧 的 时 间 ) 束 可 以 计算 出 视频 的 肯 帆 啊 应 时 间 。 如 何 确 定 开始 时 间 
和 结束 时 间 束 是 本 设计 的 关键 ， 下 面 人 简单 介绍 一 下 确定 的 方法 。 


(1) 开始 时 间 : 相对 而 言 比较 简单 ， 只 要 记录 视频 点 击 播放 按钮 
的 系统 时 间 整 可 以 确定 。 


(2) 结束 时 间 : 通过 截屏 记录 点 击 播放 按钮 到 出 现 视频 首 帧 之 间 
手机 整个 屏幕 画面 ， 然 后 从 记录 屏幕 画面 中 找 出 首次 出 现 视 频 首 帧 的 
图 片 。 由 于 不 同 的 视频 首 帧 画面 是 不 同 的 ， 所 以 在 设计 中 ， 需 要 从 播 
放 视 频 源 中 提取 原始 的 视频 首 帆 图 片 作 为 基准 图 片 ， 再 通过 基准 图 片 
和 截屏 图 片 做 比较 ， 找 出 首 帆 图 片 ， 再 把 截取 到 上 有 帧 图 片 的 系统 时 间 
作为 结束 时 间 。 


基于 上 述 方案 介绍 ， 视 频 首 帧 设计 流程 图 如 图 8-6 所 示 。 


司 动 浏览 希 并 打开 视频 页 面 


截取 当前 手机 屏幕 并 保存 为 图 片 

点 击 播放 按钮 并 记录 点 击 的 时 间 

每 间隔 60ms 截 取 一 次 手机 屏幕 快速 截屏 
下 载 当 前 视频 片 源 


播放 视频 


获取 基准 图 片 
获取 下 载 片 源 首 帧 图 片 作为 基准 图 片 


从 截屏 图 片 中 找到 和 基准 图 片 相似 的 图 片 获取 首 帧 图 片 
计算 首 帧 响应 时 间 计算 响应 时 间 


图 8-6 ”视频 衣 帧 设计 流程 图 


根据 上 述 流程 图 ， 详 细 介 绍 一 下 整个 设计 实现 的 基本 思路 : 


-播放 视频 ， 测试 工具 通过 浏览 器 打开 被 测试 视频 页 面 ， 截 取 当 前 
的 手机 屏幕 作为 图 片 文件 保存 到 SD 存 储 卡 中 ， 再 通过 相关 技术 查找 图 
瞩 文 件 上 视频 播放 的 位 置 ， 然 后 模拟 一 个 点 击 播放 按钮 事件 ， 同 时 记 
录 当 前 时 间作 为 点 击 播放 按钮 的 时 间 。 


-快速 截屏 :点击 播放 按钮 同时 启动 快速 截取 屏幕 ， 每 隔 60ms 秘 蕉 
取 一 次 屏幕 。 截 取 一 定 张 数 图 片 并 按照 当前 截取 的 系统 时 间作 为 文件 
名 一 次 性 写 入 SD 存储 卡 (例如 : 截取 总 张 数 为 120 张 ， 因 为 每 张 间隔 十 
60ms， 这 120 张 图 片 代表 着 12s 内 当前 手机 屏幕 的 变化 情况 。 


-获取 基准 图 片 : 为 了 从 这 120 张 图 片 中 找 出 首 帧 图 片 ， 需 要 下 载 
当前 视频 源 ， 再 利用 相关 技术 从 下 载 视频 源 中 提取 视频 的 原始 首 帧 图 
片 作为 基准 图 片 。 


-获取 昕 帧 图 片 ， 把 截屏 图 片 按照 文件 名 按 从 小 到 大 的 顺序 排列 ， 
再 把 基准 图 片 和 它们 逐一 比较 ， 找 到 第 一 个 相似 度 大 于 90% 的 截屏 图 片 
即 为 测试 要 找 的 下 帧 图 片 。 


计算 啊 应 时 间 : ”因为 截屏 的 图 片 文件 名 是 以 截屏 的 当前 系统 时 间 
保存 的 ， 所 以 找到 的 下 帧 图 片 文 件 名 和 点 击 播放 按钮 时 间 磊 束 古 测试 
的 首 帆 啊 应 时 间 。 


大 家 都 知道 ， 实 际 测试 中 视频 首 帧 响应 可 能 会 受到 外 界 不 同 因素 
的 干扰 〈 如 网 络 、 视 频 服务 器 等 ) 和 手机 本 身 性 能 的 影响 。 为 了 消除 
外 界 因 素 的 影响 ， 在 测试 中 ， 需 要 对 多 个 片 源 进行 测试 ， 然 后 把 它们 
的 平均 时 间作 为 响应 时 间 ， 从 而 保证 测试 数据 的 真实 有 效 性 ， 对 于 手 
机 本 身 性 能 的 影响 ， 后 面 章 节 详 细 讨论 了 选择 手机 的 标准 ， 具 体 请 参 
考 8.3.4 攻 的 第 四 部 分 


8.3 ”视频 自 帧 性 能 测试 方案 的 具体 实现 


本 市 主要 基于 前 面 介绍 的 视频 首 帧 性 能 测试 设计 思路 ， 来 逐步 介 
绍 性 能 测试 工具 的 开发 过 程 。 由 于 代码 比较 多 ， 在 举例 中 ， 只 针对 主 
要 功能 点 加 以 阐述 。 


8.3.1 开发 工具 准备 

由 于 性 能 测试 工具 是 在 Android 系 统 开 发 基础 上 进行 的 ， 所 以 先 了 
解 一 下 如 何 搭建 工具 开发 环境 ， 下 面 以 Windows 系 统 为 例 。 

在 Windows 系 统 中 搭建 应 用 程序 开发 环境 所 需要 的 工具 如 下 : 

-Java SDK (建议 Java1.6 及 以 上 版 本 ) 

:Eclipse IDE 4.4 及 以 上 版 本 

Android SDK (Windows 版 本 R24) 

Android NDK (Windows 版 本 R11) 

:ADT 插 件 


关于 这 些 工具 包 的 下 载 和 安装 ， 请 参考 相关 的 资料 。 


8.3.2 ”测试 环境 准备 


在 前 面 介 绍 的 设计 思路 中 ， 涉 及 截屏 、 获 取 下 载 片 源 首 帧 图 片 、 
查找 播放 按钮 以 及 图 片 相似 度 比较 等 功能 需要 系统 源码 和 相关 开源 库 
的 支持 ， 对 于 系统 源码 这 里 以 Android 4.4.4 系 统 为 例 进 行 曾 述 。 在 整个 
开发 过 程 中 ， 需 要 的 资源 包 如 下 : 


-OPENCV SDK (2.4.10 版 本 ) 

FFMPEG 库 

“Android 相 关 的 源 代码 头 文件 

“Android 系 统 相 关 的 动态 库 

依据 下 列 介绍 准备 与 步骤 相关 的 工具 包 。 
1.0PENCYV SDK 


OPENCV (Open Source Computer Vision Library) 是 一 个 基于 ( 开 
源 ) 发行 的 跨 平 台 计 算 机 视觉 库 ， 可 以 运行 在 Linux、Windows、Mac 
OS 以 及 Android 操 作 系统 上 “。 在 本 章 实例 中 ， 需 要 用 OPENCV SDK 和 查找 
播放 按钮 和 比较 相似 图 片 。 相 关 的 SDK 可 从 OPENCV 官 网 下 载 Android 
版 ， 然 后 依照 官方 相应 操作 步骤 把 OPENCV SDK 导 入 Eclipse 中 。 


2.FFMPEG 库 


FFMPEG 是 一 套 可 以 用 来 记录 、 转 换 数 字音 频 、 视 频 ， 并 能 将 其 
转化 为 流 的 开源 计算 机 程序 。 本 章 实 例 需要 通过 获取 下 载 视 频 源 的 原 
始 首 帧 图 乒 作 为 比较 的 基准 图 片 ， 读 者 可 以 从 FFMPEG 官 网 下 载 代 
码 ， 然 后 在 Ubuntu 系统 上 配置 NDK 环 境 ， 再 通过 编译 就 可 以 得 到 
FFMPEG 库 和 相关 的 头 文件 。 


3.Android 相 关 的 源 代 码头 文件 


在 测试 中 所 涉及 的 截屏 功能 ， 是 通过 Android 系 统 相 关 接 口 实现 
的 。 为 了 保证 编译 通过 ， 我 们 需要 从 官网 上 下 载 Android 系 统 部 分 源 代 
码头 文件 ， 在 这 里 下 载 的 Android4.4.4 系 统 头 文件 目录 如 图 8-7 所 示 。 


development 2015/8/7 16:44 


) external 2015/8/7 16:44 
frameworks 2015/8/7 16:44 
hardware 2015/8/7 16:44 


system 2015/8/7 16:44 


图 8-7 系统 相关 头 文 件 目录 


4.Android 系 统 相关 的 动态 库 


工具 编译 成 功 后 ， 为 确保 能 够 正确 链接 通过 ， 这 里 还 需要 准备 
Android 系 统 相关 的 动态 库 ， 需 要 的 动态 库 文件 在 Android 系 


统 /systenylib 目 未 下 。 因 为 前 面 下 载 的 是 Android 4.4.4 系 统 的 头 文件 ， 
里 需要 对 应 的 动态 库 也 必须 是 4.4.4 系 统 版 本 的 ， 图 8-8 所 示 为 需要 复 
制 的 动态 库 文 件 。 


_] libbinder.so 
| | lbgui.so 


| | llbskia.so 
| | libui.so 
| fibutils.so 


图 8-8 ”需要 复制 的 动态 库 文件 


8.3.3 ”工程 部 署 


前 面 已 搭建 好 了 开发 环境 并 准备 了 相关 工具 包 ， 下 面 就 可 以 开始 
按 设 计 思路 开发 测试 工具 。 


1. 创 建 Android 工 程 


在 eclipse 中 ， 创 建 一 个 Android 的 应 用 程序 ， 取 名 为 prefVideo 工 
程 ， 并 给 该 工程 添加 一 个 native 环 境 ， 如 图 8-9 所 示 。 


Rj) project Explorer 3 
> OpenCV Lbrary - 2.4.10 
4 f2 prefVideo 
4 fs src 


b 岂 com.pref.video 


by 由 gen [Generated Java Files] 
b Bi Android 5.0.1 

b BB Android Private Libraries 
b Bh Android Dependencies 

b 坊 Binaries 
b 上 Archives 


通过 点 击 工程 右键 ， 在 弹出 的 菜单 中 
选择 “Android tools ”一 “And Native 
support... ”添加 native 开发 环境 
Db 出 assets 
> 比 , bin 
D 出 res 

回 AndroidManifest.xml 

紧 | ic_launcher-web.png 


国 proguard-project.txt 


国 project.properties 


图 8-9 创建 Android 工 程 


2. 配 置 开 发 工具 包 


前 面 把 准备 好 的 相关 工具 包 导入 测试 工具 工程 ， 具 体 的 步 又 如 
下 : 


(1) 导入 OPENCV SDK。 通 过 点 击 工程 右键 ， 在 弹出 的 菜单 中 
选择 “properties” 选 项 ， 弹 出 下 列 对 话 框 ， 再 按照 对 话 框 上 标号 数字 的 


顺序 把 OPENCV SDK 导 入 perfvideo 工 程 ， 如 图 8-10 所 示 。 


合 Properties for preivideo ” 


| |type fter text | Android I 
b> Resource 到 
Androld Lint Preferences 0 | platform Apl te | 
Builders Please select a library project 2.3.3 10 | 
Java Build Path 2.3.3 10 
> Java Code Style 
y = 3.2 13 
b>» Java Editor 3 3 
Javadoc Location 40 4 
Project References 40 14 
| Run/Debug Settings 4.0.3 15 
b> Task Repository 4.0.3 15 
Task Tegs 4.1.2 16 
> Validation 41.2 16 
Woe 4.2.2 17 
4.3.1 18 后 
4.3.1 18 
4.4.2 19 
AAW.2 20 
5.0.1 21 
| 5.0.1 21 
s sa| 
| 
Fa | 
回 Is Ubrary 
Reference Proj 
[2 


图 8-10 导入 OPENCV SDK 


(2) 导入 其 他 工具 包 。 在 工程 ni 目录 下 创建 Android 和 FFMPEG 
目录 ， 然 后 把 前 面 下 载 的 Android 系 统 的 头 文件 和 库 文 件 复制 到 Android 


目录 ; 把 FFMPEG 头 文件 和 库 文件 复制 到 FFMPEG 目 录 ， 如 图 8-11 所 


4 蕊 androld 
4 对 Include 
， 世 external 
EE frameworks 


» EE hardware 


bE system 
4 EE lib 
hbbinderso 
libgui.so 
libskia.so 
libui.so 


EE ffmpeg| 
4 (= include 
区 libavcodec 
>» EE libavfilter 
;EE libavformat 
» EE: lilbavutil 
» EE lilbswresample 
» EE libswscale 
4 巴 ' lib 
lbavcodec.so 
fbavformat.so 
lbavutil.so 


避 llbswscale.so 


Android 系统 相关 
头 文件 和 库 文件 


FFMPEG 库 相 关 产 
头 文件 和 库 文件 


图 8-11 导入 其 他 相关 的 头 文件 和 库 文 件 


8.3.4 ”关键 代码 和 难点 分 析 


下 面 我 们 整 根 据 上 面 的 设计 思路 ， 依 次 来 分 析 下 列 代 码 。 


1. 局 动 麟 贤 紫 打开 视频 网 页 


在 Android 开 发 中 ，mtent 机 制 是 一 种 运行 时 绑 定 (run-time 
binding) 机 制 ， 它 能 在 程序 运行 过 程 中 连接 两 个 不 同 的 组 件 。 
Intent， 程 序 可 以 向 Android 表 达 某 种 请 求 或 者 意愿 ，Android 会 根据 意 
愿 的 内 容 选 择 适当 的 组 件 来 完成 请 求 。 例 如 ， 本 例 中 测试 工具 希望 打 
开 浏 览 器 访问 视频 页 面 ， 那 么 这 个 应 用 只 需要 发 出 ACTION_VIEW 给 
Android，Android 就 会 根据 Intent 的 请 求 内 容 ， 启 动 浏 览 器 并 打开 视频 
页 面 ， 具 体 实现 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 ”启动 浏览 器 并 打开 视频 页 面 


Intent intent = new Intent(); // 创 建 一 个 

Intent 

intent.setAction(Intent.ACTION_VIEW); // 设置 执行 动作 
intent.setData(Uri.parse(" 视 频 地 址 

") ); ”L/L 设置 打开 视频 页 面 的 

URL 
intent.setClassName("com.tencent.mtt","com.tencent.mtt.SplashActivity"); 


//com.tencent .mtt 浏览 器 包 名 


Com,tencent ,mtt,SplashActivity 浏览 器 主 


Activity 名 字 


StartActivity(intent ) ， 


在 上 面 的 代码 中 ， 关 于 浏览 器 包 名 和 主 Activity 可 以 通过 Android 
SDK 的 build-tools 目 录 下 的 aapt 命 令 来 获取 (最 新 SDK 下 aapt 命 令 和 被 测 
APP 可 能 存在 兼容 性 问题 ， 建 议 用 21.x 目 录 下 的 aapt 命 令 ) ， 具 体 如 图 
8-12 所 示 。 


:\>aapt dump xnltree qqbrowser.apk findroidManifest -xml 
: android=http://schemas.android.com/apk/res/android 
E: manifest (Cline=164> 
A: android:versionCode (Bx8181821b)=Ctype @x18)8x9a47?0 
android:versionName CBx@181021ic)="6 09.1928”" (Raw: "6.3.8.1920"> 


PotectionLeve1(9xBlDlibpo9>=(type Gxii2@x2 
E: uses-permission (line=17?5> 
A: android:nane (Bx@10186803)="com.tencent .mtt .broadcast'’ (Raw: "com.tencent .mtt .broadcast") 
E: uses-permission (line=17?6» 
fA: android:name COx@1018883="android.permission .WAKE_ LOCK CRaw: "android.permission .WAKE_LOCK"> 
E: uses—permi on 《line=1??> 
A: android:name CBx@10180883)="android.permission.ACCESS_COARSE_LOCATION" (Raw: "android.permission.ACCESS_COARSE_LO 
ATION")> 
E: uses-permission Cline=17?8>» 
A: android:name CBx@1018003)="android.permission.ACCESS_WIFI_STATE CRaw: "android.permission.ACCESS WIFI_STATE"Y 
E: activity Cline=423> 
A: android:thene (Gx@10160686) =COx?7f0f0006 主 Activity 名 


com-tencent -mtt- Se 《Raw: "com-tencent .mtt.Splashfctivity" 


A: ee pp EDs Ox11)8x22 
E: intent-filter 《line=429》 
E: action Cline=438> 
A: android:name (Bx@1018803》 ntent -ac 
E: category (line=432>» 
A: android:name CBx@10186803)="android.intent.category.LAUNCHER" (Raw: "android.intent.category.LAUNCHER"> 
E: category Cline=433» 
A: android:name CBx810188083="android.intent .category.MULTIWINDOW LAUNCHER'’ CRaw: "android.intent .category.MI 
LTIWINDOW_LAUNCHER"> 


图 8-12 ”获取 包 名 和 主 Activity 


查找 播放 按钮 


对 于 不 同 的 视频 网 站 ， 如 何 查找 播放 按钮 所 在 的 位 置 呢 ? 首先 看 
一 下 浏 咒 器 打开 的 各 个 视频 网 站 的 页 面 。 图 8-13 所 示 为 各 大 视频 网 站 播 
放 页 面 在 手机 上 的 截图 


全 秦 时 肯 月 58 一 在 寺 杜 旗 一 下 秦 时 了 朋 月 了 … , 加 太子 刀 升 职 记 01 克 培 剧 手机 乐 视 规 肥 


可 试看 15 分 另 ， 下 载 乐 视 妃 颖 观看 完 至 逝 


际 泌 上 自制] 太子 刀 升 职 记 9.4 分 


1 剧 集 


有 村 慎 兵 之 名 盎 火 第 35 集 


图 8-13 ”各 大 视频 网 站 播放 页 面 


从 图 8-13 中 我 们 可 以 看 到 ， 各 大 视频 网 站 页 面 中 的 视频 播放 按钮 有 
一 个 明显 的 共同 特征 : 播放 按钮 部 是 圆 形 的 。 由 于 图 片 是 按照 手机 相 
同比 例 截取 的 ， 那 么 只 要 找到 圆 形 在 图 片 中 的 位 置 束 可 以 获取 播放 按 


钮 的 位 置 。 获 取 圆 形 在 图 片 中 的 位 置 方 案 很 多 ， 这 里 利用 开源 
OPENCYV SDK 来 查找 圆 形 在 图 片 中 的 位 置 ， 其 具体 实现 如 代码 清单 8-2 
所 示 。 


代码 清单 8-2 ”查找 播放 按钮 


Mat dst = new Mat(); 
// 从 


SD 卡 中 读 取 当前 截屏 的 屏幕 图 片 


Mat source=Highgui.imread(" 截 取 的 当前 手机 屏幕 图 片 


mh 1); 
过 
final List<MatOofPoint> rawContours = new ArrayList<MatOofPoint>(); 
final Mat hieararchy = new Mat(); 
// 把 原 图 像 转化 成 灰 度 图 像 


Imgproc.cvtColor(source, source, Imgproc.COLOR BGR2GRAY ); 
/ /使 用 高 斯 平滑 进行 模糊 降 噪 


Imgproc.GaussianBlur(source, dst, new Size(11, 11), 0, 0); 
/ /运行 


Canny 算 子 


Imgproc.Canny(source, dst, 80, 240, 3, true); 
/ /查找 图 片 中 的 各 种 轮廓 


Imgproc ,findcontours(dst, rawCcontours,hieararchy, Imgproc,RETR_EXTERNAL， 
Imgproc .CHAIN_APPROX_SIMPLE ) ; 

for (int i = 0; i < rawContours.size(); I++) { 

MatOfPoint2f point2f = new MatOfPoint2f(); 

/ /改变 当前 轮廓 


Mat 的 属性 


rawContours.get(i).convertTo(point2f, CvType.cCV_32FC2); 
MatOoOfPoint2f approxCurve = new MatOfPoint2f(); 
/V/ 计 算 当前 轮廓 的 凸 包 ， 凸 包 也 就 是 图 形 上 的 各 个 点 


Imgproc.approxPolyDP(point2f, approxCurve,Imgproc.arcLength(point2f, true) * 0.02, 
true); 
/ /查找 当前 轮廓 面积 是 否 大 于 


20000 个 像素 的 区 


机 
If ((Math.abs(Imgproc.contourArea(approxCurve)) >20000 ) 
&& (!Imgproc.isContourConvex(rawContours.get(i))) ) 


List<Point> isConvex = new ArrayList<Point>(); 
Converters.Mat_to_vector_Point(approxCurve, isConvex); 
// 如 果 当 前 轮廓 凸 包 个 数 是 


3， 就 是 三 角形 ; 个 数 是 


4， 就 是 四 边 形 ， 依 次 类 推 。 这 里 我 们 认为 个 数 大 于 


6 时 ， 是 一 个 圆 形 。 


if(isConvex.size() >6) 


/ /计算 圆 形 的 圆 点 的 坐标 位 置 


Rectr = Imgproc.boundingRect(rawContours.get(i)); 
radius[0] = (r.x + r.width / 2); 

radius[1] = (r.y + r.height / 2); 

return radius; 


} 
} 


OPENCV SDK 提 供 了 一 个 Houghcircles 函 数 ， 也 可 以 利用 这 个 函数 
直接 获取 圆 形 ， 具 体 的 读者 可 以 参考 与 OPENCV SDK 相 关 的 文档 。 另 
外 代码 中 涉及 当前 屏幕 截取 可 以 调用 Android 系 统 自 带 的 screencap 命 令 
实现 。 


3. 播 放 视 频 并 记录 当前 开始 时 间 


天 于 模拟 一 个 事件 点 击 ， 相 信和 网 上 介绍 的 方法 很 多 。 但 是 这 些 方 
法 有 一 个 共同 的 特点 : 很 难 准确 地 记录 时 间 的 点 击 时 间 。 为 了 解决 这 
个 问题 ， 笔 者 在 这 里 采用 了 input 事 件 注入 原理 。 首 先 我 们 来 了 解 一 


Android 输 入 事件 流程 ， 在 Android 系 统 中 ，input 事 件 处 理 流程 如 图 8-14 
所 示 。 


文件 设备 答 


/dewinput/event0 


Android 内 核 /dev/input/eventl | 7 eh ee | 


ViewRootImp 
| 1 - Wi /IN 
InputReaderPolicy op eb 
/dev/input/eventN ey 


图 8-14 ”input 事 件 处 理 流程 


Android 内 核 接 受 输入 设备 的 中 断 ， 并 将 原始 事件 的 数据 写 入 设备 
节点 中 ， 然 后 由 InputManagerService 从 文件 设备 中 取出 相应 的 事件 ; 
WindowManagerService (以 下 简称 WMS) 服务 运行 在 SystemServer 进 
程 中 ， 应 用 程序 启动 Activity 时 ， 需 要 请 求 WMS 为 启动 的 Activity 创 建 
对 应 的 窗口 ， 而 WMS 启动 之 后 ， 经 逐 层 调用 ， 把 读 取 输 入 事件 传递 到 
Java 层 ; ViewRootImpl 和 WMS 之 间 的 通信 是 通过 Binder 机 制 实现 的 ， 
ViewRootImpl 获 取 到 响应 的 事件 再 分 发 DecorView (Activity 根 视图 ) ， 
并 由 它 分 发 到 相应 的 View， 这 是 Android 输 入 事件 简单 处 理 流程 。 如 果 
读者 感 兴趣 的 话 ， 可 以 参考 相关 的 书籍 和 Android 系 统 的 源 代码 。 


从 上 面 的 Android 输 入 事件 处 理 机 制 ， 可 以 很 清楚 地 知道 手机 人 硬件 
通过 内 核 驱 动 程序 把 用 户 操 作 相 应 事件 写 入 文件 设备 符 中 ， 然 后 由 
Android 系 统 从 文件 设备 从 中 读 取 事件 ， 青 通过 层 层 分 发 的 机 制 分 发 给 


我 们 的 应 用 程序 。 为 了 更 好 地 了 解 Android 系 统 事件 机 制 ， 这 里 再 看 一 
下 Android 系 统 提供 的 getevent 与 sendevent 两 个 工具 供 使 用 者 从 文件 设备 
符 中 直接 读 取 输入 事件 或 写 入 输入 事件 。 这 里 以 小 米 3 为 例 ， 通 过 
Android 系 统 的 getevent 命 令 来 获取 一 下 touch 屏 幕 某 个 位 置 所 发 生 的 系 
统 事 件 序列 ， 如 图 8-15 所 示 。 


GS:、>adb shell 
shellGcancro:/ $ getevent —1 -dd 
getoevent 1 a 
adda device 1 dev/input/events 

name : “mem9974—taiko—mtp—snd-—card Headset Jack 
add dewice 235 mdewr~inputbcewenec 了 了 

name : "mem8974—taiko—mtp—snd-—card Button Jack" 
ET 

name apnp _ pon" 
(I 
add device 4 dev/input/oeveoenti 

LE 


device 55 dev/ input/ oveont2 
name : "atmel—maxtouch" 
dev/input/ event2: EU_ ABS ABS_MT_ TRACKING_ID HO00001 45 
dev/input/oeveont2: EV _ ABS ABS_MT_ POSITION * dH00001ad 
dev/input/eveoent2: EU_ ABS ABS_ MI POSITION YY B0000202 
dev/ input/eveoent2: EV _ ABS ABS_MT PRESSURE 000004f 
dev/input/ event2: EV SYN Pd O0000000 
dev/input/event2: EV ABS ABS_MT_ PRESSURE W000003 4 
dev/ input/ eveoent2: EV _SYN SYN_REPORT 0000000 
dev/input/ event2: EV ABS ABS _ MT TRACKING_ID 在 在 在 企 丰 在 在 于 
Kdcv/input /event2: Ey SYN SYN_ REPORT 00000000 


图 8-15 getevent 获 取 touch 事 件 


从 图 8-15 中 可 以 看 到 屏幕 的 touch 是 通过 文件 设备 
符 /dewinputevent2 实 现 的 ， 只 要 向 event2 文 件 设备 符 注 入 播放 按钮 位 置 
touch 事 件 ， 就 可 以 实现 测试 的 要 求 。 这 里 对 于 Android 系 统 的 sendevent 
做 了 一 些 改造 ， 其 具体 实现 如 代码 清单 8-3 所 示 。 


代码 清单 8-3 ”模拟 点 击 事件 


#include <stdio.h> 

#include <stdlib.h> 

#include <fcntl.h> 

#include <sys/ioctl.h> 

#include <linux/input.h> 

unsigned long long getSystemTime() 


{ 


/ /计算 系统 当前 的 时 间 


7 单位 为 毫秒 。 其 功能 和 


JaVva 的 


System.currentTimeMil1LiS( ) 相 同 


Struct timeval tyv; 

gettimeofday(&tv,NULL); 

return((unsigned long long)tv,tv_sec)*1000 + ((unsigned long 
long)tv.tv_usec)/1000; 


} 


/ /这 里 实现 了 一 个 点 击 屏幕 任何 位 置 的 接口 ， 其 中 


X,Yy 


就 是 我 们 需要 点 击 屏幕 的 坐标 位 置 


void touchxY(int x ,int y) 


{ 


struct input_event event,; 
/ /打开 文件 设备 符 


int fd = open("/dev/input/event2", O_RDWR); 
// 打 开 失 败 之 间 返 下 


if(fd < 9) { 
return ; 


} 
// 定 义 一 个 


touch 事 件 的 序列 


int typevalue[] = {EV_ABS,EV_ABS,EV_ABS,EV_ABS,EV_ABS,EV_SYN,EV_ABS,EV_SYN}; 
int codevalue[] = {ABS_ MT_TRACKING_ID,ABS MT_POSITION Xx,ABS_ MT_POSITION_Y, 
ABS_MT_PRESSURE, ABS_MT_TOUCH_MAJOR, SYN_ REPORT, ABS_MT_TRACKING_ID,SYN_REPORT}; 
int eventvalue[] = { 人 0x00000145, 0x000001ad, Ox00000202, Ox0000004f, 

0Xx00000034, 90X00000000, Oxffffffff,Ox00000000}; 
for(int i = 0; i < sizeof(typevalue)/sizeof(int);i ++) 
{ 


/ /给 事件 各 个 变量 清 


memset(&event, ©0, sizeof(event)); 
event ,type = typevalue[i]; 
event ,code = codevalue[i]; 
Switch(event ,code) 


case ABS_MT_POSITION_X: 
// 把 当前 


touUch 的 位 置 坐标 


X 赋 值 给 当前 注入 的 事件 


event ,Value = x; 
break 
case ABS_MT_POSITION_Y: 
// 把 当前 


touch 的 位 置 坐标 赋值 给 当前 注入 的 事件 


event ,Value = y; 
break 
default: 

event.value = eventvalue[i]; 
break; 


} 
// 把 事件 序列 写 入 文件 设备 符 


if(write(fd, &event, sizeof(event)) < (SSslize_t) Sizeof(event ) ) { 
break; 


} 
} 
close(fd); 
A/ 打印 当 前 
touch 的 位 置 的 时 间 


printf("%]ld",getSystemTime( )); 


上 面 的 代码 仅 定义 了 一 个 touch 屏 幕 的 接口 ， 而 调用 是 在 批量 截屏 
时 实现 的 。 另 外 这 里 还 有 一 点 要 说 明 的 是 ， 不 同 机 型 通过 getevent 获 取 
的 touch 事 件 的 事件 序列 可 能 不 一 样 。 相 信 有 读者 就 会 产生 疑问 : “是 不 
是 针对 于 不 同 的 机 型 都 需要 修改 源 代 码 ? * 而 笔者 实际 在 工作 中 利用 
getevent 获 取 的 事件 序列 写 入 文件 中 ， 然 后 代码 再 从 文件 中 读 取 事件 序 
列 值 后 赋值 给 typevalue、codevalue、eventvalue 变 量 (三 个 变量 具体 含 
义 请 参考 系统 源码 inPut_event 结 构 ) ， 这 样 设 计 就 具有 一 定 的 通用 性 ， 
关于 代码 读者 可 以 自行 实践 。 


4. 快 速 截取 屏 攻 


笔者 前 期 开发 性 能 测试 工具 的 过 程 ， 采 用 录像 分 析 帧 进行 了 党 
试 。 但 是 实际 使 用 中 却 遇 到 了 很 多 问题 ， 例 如 摄像 头 清晰 度 、 摄 像 之 
间 的 距离 等 外 部 原因 ， 最 主要 的 是 由 于 视频 播放 是 动态 的 ， 摄 像 视频 
在 分 帧 以 后 ， 图 片 非常 模糊 。 在 这 种 情况 下 ， 只 能 靠 人 眼 分 析 ， 工 具 
很 难 准 确 地 比较 识别 。 鉴 于 此 ， 笔 者 阅读 了 Android 系 统 自 带 的 
screencap 命 令 的 源码 ， 发 现 它 是 调用 SurfaceFlinger 提 供 的 截屏 接口 
ScreenshotClient， 而 ScreenshotClient 通 过 进程 间 通 信 调 用 SurfaceFlinger 
service 的 截屏 功能 。 这 里 为 了 满足 性 能 测试 的 需求 ， 笔 者 基于 screencap 
命令 源 代码 对 于 截屏 做 了 以 下 几 个 方面 的 优化 。 


-截取 的 当前 屏幕 通过 struct 结 构 直 接 存 储 在 内 存 上 ， 而 不 是 立即 写 
到 文件 上 。 等 截屏 达到 一 定数 量 的 图 片 后 ， 以 每 次 截屏 的 时 间作 为 文 
件 名 一 次 性 写 入 SD 存储 卡 。 


.对 截取 的 当前 屏幕 做 了 一 定 比例 的 缩小 ， 笔 者 实际 缩小 的 比例 是 
0.3 倍 。 


-批量 截屏 的 每 次 截屏 间 阳 时 间 是 60ms 。 


通过 上 述 的 优化 ， 言 先 避免 在 截屏 中 过 多 写 入 SD 人 存储 卡 而 影响 测 
试 的 性 能 ;其 次 把 当前 屏幕 做 一 定 缩小 ， 不 仅 可 以 缩短 截屏 时 间 ， 而 
且 还 可 以 节省 存储 到 内 存 的 至 间 ;， 最 后 每 次 规 屏 间隔 60ms， 主 要 考虑 


当前 市 场 上 多 数 的 视频 帧 率 在 15 帧 / 秒 左 右 ， 也 天 是 每 帧 的 时 间 间 隔 在 
67ms 左 右 。 具 体 实现 如 代码 清单 8-4 所 示 。 


代码 清单 8-4 ”快速 截屏 


// 引 |} 


Android 命 名 空间 ， 以 便 后 面 代 码 能 直接 调 


Android 命 名 空间 的 函数 


using namespace android; 
/* 定 义 一 个 图 片 内 存 临时 保存 的 


Struct 结 构 


CUr_time 保存 截取 当前 图 片 的 系统 时 间 


pPic 图 片 保存 的 内 存 地 址 


heigth 图 片 的 高 


width ”图片 的 宽 


#7 
struct Pic Map 
{ 
unsigned long long cur_time,; 
void *pPic; 
struct Pic Map * next; 
int heigth; 
int width ， 
int format ， 
}; 


struct Pic Map *pmap = NULL; 
static void saveFrameToBuffer(const void* base,int width, 
int heigth,int strige,int bytesPerPixel,int format) 


if(base !=NULL) 
{ 


struct Pic Map *ptmp = new struct Pic_Map; 
/ /分配 一 个 内 存 空间 来 保存 当前 截屏 的 图 片 


下 


ptmp->pPic = new uint8_t[heigth*width *bytesPerPixel]; 
If (ptmp->pPic == NULL ) 
{ 


delete ptmp 


return ， 


} 
// 把 当前 


ScreenshotClient 获 取 的 当前 屏幕 图 片 复 制 到 分 配 的 内 存 空间 中 


for (int i = 0; i < heigth ; i ++) 


{ 

memcpy( (void*)ptmp->pPic + i * width* bytesPerPixel, 

(void*)(base + i * strige * bytesPperPixel), width*bytesPerPixel); 
} 
/ /保存 图 片 的 相关 参数 


ptmp->width = width,; 
ptmp->heigth = heigth; 
ptmp->format = format; 
/ /保存 截屏 的 当前 时 间 


ptmp->cur_time = getSystemTime(); 
ptmp->next = pmap; 
pmap = ptmp; 


/人 * 通 过 


SkBitmap 类 把 图 片 保 存 到 文件 中 


*/ 
static void saveImage(void *base ,const char * fname,int width ,int heigth) 


{ 
SkBitmap b; 
b.setconfig(SkBitmap: :kARGB_ 8888_Config, width, heigth); 
b.setPpixels(base); 
SkImageEncoder::EncodeFile(fname, b, 
SkImageEncoder::kPNG_ Type, SkImageEncoder::kDefaultQuality); 


} 
/* 把 


Struct 结 构 中 的 图 片 批 量 保存 到 文件 中 


4 
static void saveBufferToImage(const char *dir) 


{ 
char path[256]; 
do 
{ 
struct Pic Map *ptmp = pmap; 
if (ptmp) 
{ 


pmap = ptmp->next,; 
// 以 当前 截屏 的 时 间作 为 文件 名 保存 图 片 


sprintf(path,"%s/%]lld.png",dir,ptmp->cur_time); 
saveImage( (void*)ptmp->pPic,path,ptmp->width,ptmp->heigth); 
/ /释放 临时 存放 图 片 的 内 存 空间 


if(ptmp->pPic) 
delete ptmp->pPic; 
delete ptmp; 


else 


{ 


break; 


}while(true); 
} 
int main(int argc, char** argv) 
{ 
// 把 传 入 的 


X,Y) 坐标 转换 为 整形 


atoi(argv[1]); 
atoi(argv[2]); 


void const* base 

Uint32 t w = 0,h 

size_t size = 0; 
ScreenshotClient screenshot,; 
// 初 始 化 


Si 


ProcessState: :Self()->startThreadPool( ) ， 
sp<IBinder> display = SurfaceComposerClient::getBuiltInDisplay( 
ISurfaceComposer::eDisplayIdMain); 
if (display !=NULL) 


status_t rv = UNKNOWN_ERROR,; 
for (int i = ©0; i< count + 1; i++) 
{ 
unsigned long long cur_start = getSystemTime(); 
/ /获取 当前 屏幕 


if Co == 0 )|| (h == 0)) 


rv = screenshot.update(display); 


一 
人 
ll 


screenshot.update(display,w,nh); 
if (rv == NO_ERROR) 


if (i == 0) 


/ /获取 当前 屏幕 的 宽 和 高 后 ， 计 算 缩 放 后 的 宽 和 高 的 大 小 


Ww = screenshot.getwidth( 


7) * O33 
h = screenshot.getHeight() * 0.3; 


cp 


else 


~ 


// 把 当前 的 屏幕 保存 到 临时 内 存 


Struct 中 
SaveFrameToBuffer(screenshot ,getPixels(),Screenshot .getwidth( )， 


Screenshot .getHeight(),Sscreenshot ,getStride(),bytesPerPixel(screenshot ,getFormat( ) 
) ,Screenshot .getFormat( ) )， 


Screenshot release()， 
/ /从 截取 第 三 张 图 片 开 始点 击 播放 按钮 ， 这 样 可 以 避免 截取 第 一 张 图 片 耗 时 比较 多 而 影响 测试 的 性 能 


if (i == 3) 
touchXY (x,y); 


unsigned long long end_ start = getSystemTime(); 
/ /如 果 当 前 截屏 时 间 小 于 


60ms， 挂 起 当前 线程 


if(end_start - cur_start < 60* 1000) 
{ 
usleep(60 * 1000 - (end_ start - cur_start)); 


} 
// 把 


Struct 结 构 的 图 片 保存 到 


SD 卡 上 


SaveBufferToImage(fname ) ， 
return true 


} 


细心 的 读者 也 许 会 问 ， 这 种 批量 快速 截屏 是 否 会 影响 测试 的 性 
能 ? 笔者 在 设计 工具 的 前 期 在 几 球 不 同 的 机 型 上 做 了 大 量 实验 ， 与 隶 
屏 分 帧 的 方法 做 了 对 比 ， 两 种 测试 的 结果 基本 相同 ， 误 差 大 概 在 +59%。 
从 这 几 识 实验 的 机 型 中 笔者 发 现 ， 如 来 截屏 所 耗 用 的 时 间 小 于 每 次 截 
屏 的 间 隅 时 间 的 113， 十 不 影响 性 能 测试 结 末 的 ， 在 这 里 读者 也 可 以 结 
合 日 己 的 项 目 验 证 一 下 。 


这 里 以 小 米 3 为 例 。 在 QQ 浏览 器 页 面 播放 视频 的 情况 下 ， 每 隔 
60ms 和 截取 一 次 当前 屏幕 ， 和 截取 当 前 屏幕 的 耗 时 平均 在 12ms， 图 8-16 所 
示 为 多 次 截取 屏幕 的 每 次 耗 时 情况 。 
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图 8-16 多 次 截取 屏幕 的 每 次 耗 时 情况 


从 图 8-16 中 可 以 看 出 ， 每 次 截取 当前 屏幕 所 消耗 时 间 的 资源 比较 
少 ， 而 且 目 前 市 场 上 大 多 数 手机 配置 比 小 米 3 手机 低 的 并 不 多 ， 所 以 这 
种 方法 就 能 满足 市 场 上 主流 手机 测试 的 需求 。 


在 前 面 快速 截屏 部 分 ， 工 具 已 经 完成 了 视频 播放 过 程 的 截屏 ， 批 
量 截 屏 图 片 如 图 8-17 所 示 。 


四 


7062389404 145706238947 1457062389548 1457062389626 一 人 


570D62389974 1457062390042 1457 112 1457062390181 #570623902465 


57062390569 1457062390643 a5706239085 


图 8-17 ”批量 截屏 图 片 


从 图 中 能 很 快 辨认 出 选中 的 图 片 束 是 需要 找 的 首 帧 图 片 。 但 是 如 
何 才 能 利用 工具 目 动 识别 呢 ? 为 了 解决 这 个 问题 ， 先 来 简单 了 解 一 
视频 原理 : 视频 其 实 也 是 由 连续 变化 的 图 片 〈 称 为 帧 ) 组 成 的 ， 视 频 
在 播放 过 程 中 吏 是 把 这 些 连 续 图 片 平滑 显示 出 来 ， 利 用 人 的 视觉 短暂 
原理 ， 因 为 人 眼 无 法 辨别 单 幅 静态 画面 。 所 以 该 播放 族 源 首 央 其 实 也 
苹 一 张 图 片 ， 只 要 提取 片 源 首 帆 原始 作为 基准 图 片 ， 再 和 截屏 图 片 逐 
一 比较 ， 束 可 以 找 出 截屏 中 的 自 帆 图 片 。 为 了 方便 提取 厂 源 自 帕 原始 
图 片 ， 这 里 束 需 要 下 载 当 前 视频 片 源 。 怎 么 才能 获取 视频 的 真实 地 址 
呢 ? 这 里 利用 Android 系 统 的 Webview 打 开 当 前 视频 片 源 页 面 ， 然 后 通 


过 JavaScript 代 码 注 入 的 方式 获取 当前 片 源 的 视频 地 址 源 ， 例 如 当前 打 


开 的 一 个 视频 页 


1 面 后 在 HTML 页 面 中 所 看 到 的 真实 地 址 如 图 8-18 所 示 。 


其 中 Video 标 签 属 性 src 值 束 是 播放 视频 源 的 真实 地 址 。 而 HTML 所 


有 页 面 元 素 的 页 面 属性 都 可 以 通过 JavaScript 获 取 ， 所 以 这 里 可 以 通 
Java 和 JavaScript 之 间 的 通信 获取 Video 标 签 的 src 属 性 ， 具 体 实现 如 代码 


清单 8-5 所 示 。 


Section class="yk-player”> 
vadiv class="yk-player-inner" id="player” style="width: 1889px;i height: 437px;"> 


vx<div id= 


"Xx Player class="x-player” 


<video Class= "Xx- video- ee id= NE ee video” “width: 


ht 7Kk.YOUKU . CT/ os 
BKA1Dy%28J]3%28MJijTDZmeDAUTtKICVsfHxbl zCxR8ropB9dLT9fJq308R7MOC9U%3D&V1=8"> 


图 8-18 ” HTML 页 面 视频 真实 地 址 


代码 清单 8-5 ”获取 视频 源 地 址 


/ /创建 一 个 
Webview 对 象 
WebView webV = 
// 设 置 当前 
Webview 支 持 


javascript 


new WebView(getApplicationContext()); 


webV.getSsettings().setJavascriptEnabled(true); 


// 向 
webview 注 入 一 个 


java 对 象 ， 通 过 这 个 对 


象 的 


javascript 可 以 返 划 


相关 的 结果 


webV.addJavascriptIinterface(new Object(){ 


public String getResult(String vAddr) 
return vAddr; 


} 
}, "JS_RESULT"); 
// 注 入 


javascript 肢 本， 然后 通过 注入 


jaVva 对 象 的 


getResult 汉 下 


javascript 结 果 


webV .loadUrl("javascript:JS RESULT.getResult(document .getElementsByTagName 
('video')[0].src)"); 


上 壕 实 现 方 式 是 JavaScript 代 码 获 取 视 频 真 实地 址 的 一 种 简单 方 
式 ， 但 是 随 着 各 大 网 站 的 升级 和 维护 ， 可 能 要 针对 不 同 网 站 开发 不 同 
的 JavaScript 脚 本 。 笔 着 在 实际 工作 中 使 用 tcpdump 源 代码 方案 奉 代 这 种 
方案 ， 这 种 方案 的 基本 原理 就 古 打 开 视 频 网 页 之 后 ， 监 听 网 络 数据 
包 ， 然 后 在 代码 中 分 析 数 据 包 ， 找 出 播放 视频 的 真实 地 址 。 下 面 是 播 
放 某 一 网 站 视频 后 ， 通 过 tcpdump 抓 取 的 数据 包 ， 如 图 8-19 所 示 。 


uku/6571DF745D63F822902C092830/030020010036DFDE2B12D6003E8803E139A79F-F6CB-B13 


ENS yo Osan RPT -FOCB-5135-77CB-D54711505E73, mp4 HTTP/L. IN\Nr\n 
9 [Expert Irfo Ean Ce): T /youl 5-77C8B-D954711609E73.mp4 HTTP/1.1\r\n] 
Request Me 
Requ 


od: 
5t URI; /you 3 /5571DF745D63F822902C092850/030020010056DFDE2612D6003EB803E139A79F-FGC6-6135-77C6-D54711B05E73.mp4 
version: HTTP/1.1 


图 8-19 tcpdump 抓 取 的 视频 真实 地 址 


图 8-19 中 选中 的 部 分 就 是 播放 锋 播 放 视 频 的 真实 地 址 ， 所 以 在 代码 
中 只 要 分 析 监 听 网 络 数据 包 ， 囊 能 获取 视频 地 址 。 但 是 采用 这 种 方式 
实现 ， 相 对 来 说 代码 量 大 ， 过 滤 视 频 地 址 处 理 比较 复 洒 。 所 以 有 兴趣 
的 读者 可 以 结合 目 己 的 项 目 壬 试 一 下 。 


接 下 来 利用 视频 的 真实 地 址 下 载 该 片 源 ， 视 频 下 载 这 里 是 通过 
Android 系 统 的 DownloadManager 来 实现 的 ， 具 体 实 现 如 代码 清单 8-6 所 


泵 。 
代码 清单 8-6 ”下载 视频 


/ /创建 一 个 


DownloadManager 

DownloadManagerdownloadManager = (DownloadManager) 
getSystemService(Context .DOWNLOAD_SERVICE); 

//VAddr 是 


javascrIpt 返 回 的 视频 真实 地 址 


Uri uri = Uri.parse(vAddr); 
DownloadManager .Request request = new Request(uri); 
/ /设置 当 前 下 载 片 源 地 址 和 文件 名 


request.setDestinationInExternalpPublicDir("prefvideo", "video.mp4"); 
/ /请 求 下 载 当前 片 源 


downloadManager .enqueue(request); 


上 上 面 的 代码 完成 了 视频 下 载 的 基本 功能 ， 笔 者 发 现 ， 现 在 市 场 上 
好 多 主流 视频 播放 天 都 文 持 预 缓 存 功能 。 也 束 是 在 播放 当前 族 源 的 时 
候 ， 播 放 融 已 经 把 当前 播放 片 源 预 移 缓 存 到 手机 的 存储 卡 上 的 某 个 位 
置 ， 如 末 该 App 实 现 了 这 样 的 功能 的 话 ， 我 们 束 可 以 和 省略 下 载 视频 源 这 
一 步 ， 直 接 用 缓存 的 视频 源 。 


图 注意 ”现在 部 分 视频 网 站 的 视频 地 址 源 是 m3u8 格 式 的 ， 所 以 
下 载 这 类 的 片 源 ， 要 先 解析 m3u8 文 件 ， 再 进行 视频 源 的 下 载 。 


6. 获 取 比 较 基准 图 片 


这 里 利用 FFMPEG 库 从 下 载 源 中 提取 当前 视频 的 第 一 由 图 片 作为 
基准 图 片 ， 但 这 里 包括 两 部 分 。 


JNI 部 分 ， 利 用 FFMPEG 库 解码 当前 视频 厂 源 ， 拓 取 视 频 的 首 帧 。 


Java 部 分 : JNI 部 分 通过 Java 的 bitmap 类 创建 图 片 文件 ， 然 后 再 通 
过 Java 的 目 定 义 的 函数 把 视频 自 帆 写 入 图 片 文 件 中 。 


下 面 分 别 列 取 了 JNI 部 分 和 Java 部 分 的 代码 。 具 体 实现 如 代码 清单 
8-7 和 代码 清单 8-8 所 示 。 


代码 清单 8-7 JNI 提 取 视 频 首 帧 图 片 


#include <jni.h> 

#include <wchar.h> 
#include<android/bitmap.h> 
// 导 入 


FFMPEG 相 关头 文件 


extern "CcC"{ 

#include <libavcodec/avcodec.h> 
#include <libavformat/avformat.h> 
#include <libswscale/swscale.h> 
#include <libavutil/pixfmt.h> 


static void SaveFrame(JNIEnv *pEnv, jobject pObj, char *image_name, jobject 
pBitmap, int width, int height) { 

jmethodID sSaveFrameMID; 

jclassFFMPEGC1s,; 

// 其 中 


saveFrameToPath 是 我 们 在 


JaVa 代 码 


FFMPEG 类 的 一 个 方法 ， 通 过 调用 这 个 方法 保存 文件 


FFMPEGC]1s = pEnv->GetobjectClass(pobj ) ， 
SSaveFrameMID = pEnv->GetMethodID( FFMPEGC]s， 
"saveFrameToPath", "(Landroid/graphics/Bitmap;Ljava/lang/String;)V"); 
jstring filePath = pEnv->NewStringUTF( image_name ) ， 
pEnv->CallVoidMethod( pObj, sSaveFrameMID, pBitmap, filePath) 
} 
static jobject createBitmap(JNIEnv *pEnv, int pwidth, int pHeight) { 
int i; 
/ /获取 


Android 系 统 
bitmap 类 和 
createBitmap 方 法 


ID 

jclass javaBitmapClass = (jclass)(pEnv)->FindClass( "android/graphics/Bitmap"); 
jmethodID mid = pEnv->GetStaticMethodIiD(javaBitmapClass, 

"createBitmap", "(IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;"); 
const wchar_t* configName = L"ARGB_ 8888" 

int len = wcslen(configName); 

jstring jConfigName; 

//wWCchar 转 换 为 


jchar 
if (sizeof(wchar_t) != sizeof(jchar)) { 
jchar* str = (jchar*)malloc((len+1)*sizeof(jchar)); 
for (i = 0; i < len; ++i) f{ 
str[i] = (jchar)configName[i]; 


} 
str[len] = 0; 
jCconfigName = pEnv->NewString( (const jchar*)str, len); 
} else { 
jCconfigName = pEnv->NewString( (const jchar*)configName, len); 
} 


// 调 | 


Android 系 统 


bitmap 类 创建 一 个 图 片 文件 


jclass bitmapConfigClass = pEnv->FindClass( 
"android/graphics/Bitmap$Config"); 
jobject javaBitmapConfig = pEnv->CallSstaticobjectMethod(bitmapConfigClass, 
pEnv->GetStaticMethodID( bitmapConfigClass, "valueof",™" 
(Ljava/lang/String;)Landroid/graphics/Bitmap$Config;"), jConfigName); 
return pEnv->CallStaticobjectMethod( javaBitmapClass, mid, 
pwidth, pHeight, javaBitmapConfig); 


JNIEXPORT jboolean JNICALL Java com pref_video_FFMPEG_ getFirstkKeyFrame (JNIEnV * 
env, jobject thisz,jstring video name, jstring image name) 


{ 

AVFormatContext *pFormatCtx = NULL; 
int videoStream; 
AVCodecContext *pCodeccCtx = NULL; 
AVCodec *pCodec = NULL; 
AVFrame *pFrame = NULL; 
AVFrame *pFrameRGBA = NULL， 


AVPacket packet,; 


int frameFinished,; 
jobjectbitmap; 

void* buffer ， 

AVDictionary *optionsDict = NULL; 
struct SwsContext *sws_ctx = NULL; 
char *videoFileName,*imageFileName; 

// 相关 初始 化 


av_register_all(); 


/ /转换 

jstring 为 

C++ 字符 串 

videoFileName = (char *)env->GetStringUTFChars(video _ name, NULL); 
imageFileName = (char *)env->GetStringUTFChars(image_name, NULL); 


/ /打开 视频 文件 


if(avformat_open_input(&pFormatCtx, videoFileName, NULL, NULL)'!'=0) 
return; 
// 检索 流 信息 


if(avformat_find_stream info(pFormatCctx, NULL)<0) 
return; 

av_dump_format(pFormatctx, 0, videoFileName, 0); 

// 查找 第 一 个 视频 流 


VideoStream=-1， 
for(int i=0; i<pFormatCtx->nb_streams; I++) { 
if(pFormatCtx->streams[i]->codec->codec_ type==AVMEDIA TYPE_VIDEO) { 
videoStream=i; 


break; 
} 
if(videoSstream==-1) 
return; 


pCodecctx=pFormatCtx->streams[videostream]->codec,; 
/ /查找 视频 流 的 解码 器 


pCodec=avcodec_find_decoder(pCodecCtx->codec_id); 
if(pCodec==NULL) { 
fprintf(stderr, "Unsupported codec!\n"); 
return; 


} 
// 打开 解码 器 


If(avcodec_open2(pCcodecCctx，pcodec，&optionsDict)<0) 
return; 
// 申请 一 帧 内 存 


pFrame=avcodec_alloc_frame() 
pFrameRGBA=avcodec_alloc frame( ); 
if(pFrameRGBA==NULL) 


return; 
/ /创建 一 个 


bitmap 
bitmap = createBitmap(env, pCodecCtx->width, pCodecCtx->height); 
If (AndroidBitmap_lockPixels(env, bitmap, &buffer) < 0) 
return; 
sws_ctx = sws_ getContext(pCodecCtx->width,pCodecctx->height,pCodecctx->pix_fmt, 
pCodeccCtx->width,pCodecCtx->height,AV_PIX_FMT_RGBA, SWS_BILINEAR, 
NULL, NULL, NULL); 
avpicture_fill((AVPicture *)pFrameRGBA, (uint8_t* ) buffer,AV_PIX_FMT_RGBA., 
pCodecctx->width, pCodecctx->height); 
while(av_read_frame(pFormatCtx, &packet)>=0) { 
/ /判断 是 否 为 视频 帧 


if(packet.stream index==videoStream) { 
// 解码 视频 帧 


avcodec_ decode video2(pCodecCtx, pFrame, &frameFinished,é&packet); 
if(frameFinished) { 
// 从 其 原 有 格式 转换 为 


iT 


RGBA 图 像 


sws_scale (sws_ctx, (uint8_t const * const *)pFrame->data,pFrame- 

>linesize,o0, 
pCodeccCtx->height,pFrameRGBA->data, pFrameRGBA->linesize); 
SaveFrame(env, thisz, imageFileName,bitmap, 
pCodecctx->width, pCodecctx->height); 

break; 

} 
} 
av_free_packet(&packet ) ; 


/ /释放 内 存 ， 关 闭 解码 器 和 文件 


AndroidBitmap_unlockPixels(env, bitmap); 
av_free(pFrameRGBA) ， 

av_free(pFrame ) ， 
avcodec_close(pCcodecCtx) ; 
avformat_close_input(&pFormatCtx ) ， 
return true 


} 


代码 清单 8-8 Java 类 实现 代码 


public class FFMPEG { 
public String getFirstkeyFrame() 


{ 
getFirstKeyFrame(" 视 频 文件 


"7 "截取 首 帧 图 片 文 件 


"); 


到 
王 
4 
六 


if ((new File(" 截 取 首 帧 攻 


")).exists()) 
{ 


return "截取 首 帧 图 片 文件 


} 


return null; 


} 
// 提 供给 


JNI 保 存 的 图 片 文 件 


private void saveFrameToPath(Bitmap bitmap, String pPath) { 
int BUFFER_SIZE = 1024 * 8,; 

try 苹 
File file = new File(pPath ) ， 

file.createNewFile(); 

FileOutputStream fos = new FileOutputStream(file); 
final BufferedoutputStream bos = new BufferedOutputStream(fos, BUFFER_ SIZE); 
bitmap.compress(CompressFormat.JPEG, 100, bos); 
bos.flush(); 
bos.close( ); 
fos.close( ); 

} catch (FileNotFoundException e) { 
e.printSstackTrace( ); 

} catch (IOException e) { 

e.printSstackTrace( ); 


} 


} 
//JNI 获取 视频 文件 首 帧 图 片 文件 接口 


public native void getFirstkeyFrame(String vname,String iname ) ， 
/ /加载 


FFMPEG 相 关 的 库 

static { 
System.loadLibrary("avutil"); 

System.loadLibrary("avcodec"); 

System.loadLibrary("avformat"); 


System.loadLibrary("swscale"); 
System.loadLibrary("FFMPEG"); 


} 
} 


读 到 这 里 ， 如 果 读 者 对 于 代码 实现 的 理解 有 一 定 的 难度 ， 或 者 党 
得 这 种 方式 实现 比较 复杂 的 话 ， 推 荐 读者 直接 使 用 编译 好 的 FFMPEG 


命令 来 实现 ，FFMPEG 命 令 在 Android 命 令 行 模 式 下 执行 结果 如 图 8-20 
所 示 。 


mootRcancro:/data/local/tmp # CZffmpeg mb AsdcazrdA 1 -mp4 -~t 0 Asdcard/test-jpg 
4 -t @ /sdcard/test .jpg A es 
ffmpeg version 2.3.1 Copyright Cc> 2000-2014 the FFmpeg developers 

built on hug 2 2914 22:39:12 with gcc 4.8 CGCCY> 

conf iguration: 一 pref ix=’ /hone/magiclen/ 滑 明 级 /ffnpeg-2.3.1/android/arm_neon’ -enable-static 一 -en 


hle-menalign-hack 一 disahble-doc ~—-disable-ffplay ~—-disabhle-ffprobhe —-disable-ffserver ——cross—prefi 
m=/home/magiclen/android-ndk-ri@/toolchains/arm-linux-androideabi-4.8/prebuilt/linux—-x86_64/bin/arm- 
linux-androideabi— —-target-os=linux -一 arch=akm —-—-enable-cross-compile -~-sysroot=/home/magiclen/andr 
oid—ndk-—ri@/platforms/android-19/arch-arm/ —-extra-cf lags=’—0s -fpic —marm -march=armu7-a —mfpu=neon 
-mf loat—-abi=softfp ~mvectorize—with-neon—quad’ —-extra—ldf lags=’ -Wl],.—fix-cortex-—a8’ 


图 8-20 FFMPEG 获 取 视 频 的 首 帧 图 片 


在 代码 中 ， 可 以 直接 利用 Java 的 “Runtime.getRuntime () .exec” 东 
数 来 实现 。 读 者 可 以 党 试 一 下 ， 笔 者 在 这 里 就 不 再 赣 述 了 。 


TE 


这 部 分 代码 主要 是 从 批量 截屏 图 片 中 找 出 和 从 视频 源 中 提取 的 首 
帧 原始 图 片 相似 的 图 片 。 需 要 读者 注意 的 是 ， 由 于 截屏 的 图 片 中 可 能 
会 存在 多 张 与 基准 图 片 相似 的 图 片 ， 所 以 要 把 基准 图 片 按照 文件 名 
(文件 名 就 是 截屏 系统 时 间 ) 排序 ， 第 一 次 出 现 相似 的 图 片 就 是 测试 
需要 找 的 首 帧 图 片 。 关 于 图 片 相似 度 对 比 这 里 通过 OPENCV SDK 中 比 
较 直 方 图 的 方式 来 实现 ， 具 体 实现 如 代码 清单 8-9 所 示 。 


代码 清单 8-9 ”比较 图 片 相似 度 


//basePic 是 通过 


FFMPEG 截 取 的 基准 首 帧 图 片 文件 路 径 


Mat base=Highgui.imread(basePic,1); 
/ /把 基准 图 像 转化 成 


HSV 图 像 


Imgproc.cvtColor(base, base, Imgproc.COLOR_ RGB2HSV ); 
Mat bhist = new Mat(); 

MatoOfInt histSize = new MatOfInt(25); 

MatOofFloat ranges = new MatofFloat(0f, 256f); 

/ /计算 图 像 的 直方 图 


Imgproc.calcHist(Arrays.asList(base), new MatOfInt(0), new Mat(), bhist, histSize, 
ranges ) ， 
// 这 里 的 


和 牛 ] 工 st 是 批量 截屏 的 文件 列表 ， 并 且 按 截屏 的 时 间 前 往 后 大 排列 


for (File f: flist) 


Mat tmat=Highgui.imread(f.getPath(),1); 
Imgproc.cvtColor(tmat, tmat, Imgproc.COLOR_ RGB2HSV ) ， 
Mat thist = new Mat(); 

/ /计算 图 像 的 直方 图 


Imgproc.calcHist(Arrays.asList(tmat), new MatOfInNnt(0), new Mat(), thist, histSize, 
ranges); 
/ /比较 查找 图 片 和 基准 图 片 的 相似 度 


double res = Imgproc.compareHist(bhist, thist, Imgproc.CV_COMP_CORREL ) ， 
/ /如 果 相 似 度 大 于 


9 . 9, 则 认为 这 个 就 是 我 们 要 找 的 首 帧 图 片 


if (res >= 0.9) 


return f.getName(); 


另外 还 需要 说 明 的 是 ， 一 些 播放 器 在 视频 播放 过 程 中 ， 并 非 全 屏 
播放 。 这 里 需要 从 截屏 图 片 中 提取 视频 播放 区 域 的 图 片 ， 具 体 方法 可 
以 参考 UIAutomator 一 节 ， 视 频 通 过 UIAutomator 工 具 获 取 视 频 所 在 屏幕 
的 起 始 位 置 和 宽 高 ， 如 图 8-21 所 示 。 


根据 UIAutomator 获 取 起 始 坐标 和 结束 坐标 ， 然 后 通过 Java 类 图 片 
处 理 相关 函数 ， 把 截屏 图 片 的 视频 区 域 提 取出 来 ， 这 样 再 比较 首 帧 图 
片 相 似 度 就 不 会 受 非 全 屏 播放 的 影响 了 ， 关 于 这 部 分 代码 也 不 再 袭 述 
了 ， 请 读者 自行 实践 。 


8. 计 算 啊 应 时 间 


啊 应 时 间 的 计算 相对 来 说 比较 简单 ， 束 古 把 找到 的 相似 的 图 片 的 
文件 名 利用 Java 的 Long 类 的 parseLong 函 数 转换 Long， 然 后 再 减 去 播放 
时 间 就 是 测试 工具 所 需要 的 响应 时 间 了 ， 具 体 代码 这 里 不 再 列 出 ， 请 
读 考 目 行 编写 。 


4 (0) FrameLayout [0,60][1080,668] 

4 (0) RelativeLayout [0,60][1080,668] 
视频 所 在 区 。 4 (0) FrameLayout [0,60][1080,668] 
域 View 的 (0) View [0,60][1080,668] 
起 始 坐标 和 ” 4 (1) RelativeLayout [0.60][1080.668] 

宽 
(1) TextView [0,60][1080,668] 
» (2) FrameLayout [0,60][1080,668] 
咎 宽 空 府 春 欲 晚 TV 版 (3) ImageView [915,105][1035,184] 
4 (1) FrameLayout [0,668][1080,1920] 
@ 4.7 亿 次 播放 4 (0) LinearLayout [0,668][1080,1920] 
4 (0) RelativeLayout [0,668][1080,1920] 


不 宪 齐 空 庭 春 欲 晚 号 re 4 (0) FrameLayout [0,668][1080,1920] 
, 4 (0) FrameLayout [0,668][1080,1920] 


4« 


| 选集 Node Detail 
index 


text 


resource-id com.youku.phone:id/surface view 


class android.view.View 
package com.youku.phone 
送 会 员 先 Da 花絮 推 大 || content-desc 


checkable false 
| 花架 checked false 


CR 


图 8-21 UIAutomator 获 取 视 频 区 域 位 置信 息 


8.3.5 “编译 环境 配置 


到 这 里 ， 已 完成 了 整个 工具 的 详细 实现 过 程 ， 为 了 确保 工具 代码 
正常 编译 和 工具 正常 执行 ， 需 要 对 涉及 的 Android NDK 和 SDK 两 部 分 
代码 配置 正确 的 权限 与 编译 环境 。 


1.AndroidManifest.xml 配 置 


大 家 都 知道 ， 在 Android SDK 开 发 中 ， 如 采 需 要 访问 资源 和 连接 
网 络 ， 必 须 在 配置 文件 中 对 权限 加 以 声明 ， 人 否则 将 无 法 正常 工作 。 而 
前 面 介绍 的 通过 系统 DownloadManger 下 载 视 频 源 ， 需 要 访问 网 络 和 读 
写 存 取 卡 ， 所 以 需要 在 配置 文件 中 增加 网 络 和 存 取 卡 的 权限 ， 配 置 如 
下 面 的 代码 所 示 。 


<uses-permission android:name="android,permission.INTERNET'" />// 访 问 网 络 权限 


<uses-permission android:name="android.permission.WRITE_ EXTERNAL_ STORAGE " /> 
// 写 存储 卡 权限 


2.Android.mk 配 置 


前 面 涉及 input 事 件 注入 、 批 量规 屏 以 及 获取 视频 原始 诈 帧 的 代码 
都 是 通过 NDK 方 式 实现 的 ， 为 了 能 保证 它们 正常 编译 和 链接 ， 在 配置 


文件 中 需要 配置 头 文件 路 径 、 链 接 库 文件 、 编 译 的 源 文 件 以 及 产生 的 
动态 库 或 者 可 执行 文件 ， 具 体 相 关 配 置 如 代码 清单 8-10 所 示 。 


代码 清单 8-10 Android.mk 配 置 


# 指 明 编 译 的 工作 路 径 


LOCAL_PATH:= $(call my-dir) 
# 配 置 利用 


ffmepg 获 取 首 帧 编译 环境 


include $(CLEAR_VARS) 
LOCAL_ MODULE :=1ibavcodec 
# 注 意 ， 如 果 提 示 找 不 到 对 应 文件 的 错误 ， 需 要 根据 


eclipse 的 提示 信息 调整 相关 路 径 


LOCAL_SRC_FILES :=$(LOCAL_ PATH)/../FFMPEG/1ib/libavcodec.so 
include $(PREBUILT_SHARED_LIBRARY) 

include $(CLEAR_VARS ) 

LOCAL_MODULE :=l]ibavformat 

LOCAL_SRC_FILES :=$(LOCAL_PATH)/../FFMPEG/1ib/libavformat.so 
Include $(PREBUILT_SHARED_LIBRARY) 

include $(CLEAR_VARS ) 

LOCAL_MODULE := 1ibavutIl 

LOCAL_SRC_FILES :=$(LOCAL_PATH)/../FFMPEG/1ib/libavutil.so 
Include $(PREBUILT_SHARED_LIBRARY ) 

include $(CLEAR_VARS ) 

LOCAL_MODULE := 1ibswscale 

LOCAL_SRC_FILES :=$(LOCAL_ PATH)/../FFMPEG/1ib/libswscale.so 
include $(PREBUILT_SHARED_LIBRARY) 

include $(CLEAR_VARS) 

LOCAL_C_INCLUDES := $(LOCAL_PATH) 

## 编 译 所 需要 头 文件 和 库 文 件 


LOCAL_C_INCLUDES += $(LOCAL_PATH)/FFMPEG/include 
LOCAL_LDLIBS := -11og -ljnigraphics -lz -landroid 
# 链 接 的 动态 库 


LOCAL_SHARED_LIBRARIES := libavcodec libavformat libavutil libswscale 
# 指 明 需 要 编译 的 源 文件 


LOCAL_SRC_FILES :=FFMPEG.cpp 
# 指 明 编译 产生 的 动态 库 文件 


LOCAL_MODULE :=FFMPEG 


# 产 生动 态 库 文件 ， 方 便 在 


JaVa 代 码 中 进行 加 载 


include$(BUILD_ SHARED_LIBRARY) 
# 配 置 截屏 编译 环境 


include $(CLEAR_VARS) 
ANDROID_INCLUDE_PATH := $(LOCAL_PATH)/android/include 
ANDROID_LIB_PATH := $(LOCAL_PATH)/android/l1ib 
LOCAL_C_INCLUDES := $(LOCAL_PATH) 
LOCAL_C_INCLUDES += \ 
$(ANDROID_INCLUDE_ PATH)/frameworks/base/native/include\ 
$(ANDROID_INCLUDE_ PATH)/frameworks/base/include\ 
$(ANDROID_INCLUDE_ PATH)/frameworks/base/libstagefright\ 
$(ANDROID_ INCLUDE_ PATH)/frameworks/base/include/media/stagefright/openmax\ 
$(ANDROID_ INCLUDE_ PATH)/frameworks/base/libstagefright/include \ 
$(ANDROID_ INCLUDE_ PATH)/frameworks/native/include \ 
$(ANDROID_ INCLUDE_ PATH)/hardware/libhardware/include \ 
$(ANDROID_ INCLUDE_ PATH)/system/core/include \ 
$(ANDROID_ INCLUDE_ PATH)/external/skia/include/core \ 
$(ANDROID_INCLUDE_ PATH)/external/skia/include/effects \ 
$(ANDROID_INCLUDE_ PATH)/external/skia/include/images \ 
$(ANDROID_ INCLUDE_ PATH)/external/skia/src/ports \ 
$(ANDROID_ INCLUDE_ PATH)/external/skia/include/utils 
LOCAL_LDLIBS := -llog -ljnigraphics -lz -landroid 
LOCAL_LDLIBS += -Wl1,-rpath=$(ANDROID_LIB_PATH)\ 
-L$(ANDROID_LIB_PATH)\ 
-lutils\ 
-lbinder\ 
-lskia\ 
-]ui \ 
-lgui 
LOCAL_CFLAGS += -DHAVE_SYS UIO H #redefinition of 'struct iovec' 
# 编 译 


takeshot 和 

eVent 两 个 

CPpp 文 件 

LOCAL_SRC_FILES :=takeshot.cpp \ 
event.cpp 


LOCAL_MODULE :=takeshot 
# 编 译 可 执行 文件 


include$(BUILD EXECUTABLE) 
# 配 置 

OPENCV 编 译 环境 

OPENCV_CAMERA MODULES:=on 


OPENCV_INSTALL_MODULES :=on 
# 指 明 


opencyv .mk 文件 所 在 位 置 ， 这 个 主要 取决 于 下 载 解压 文件 所 在 的 路 径 


include F:/opensource/library/OPENCV-2.4.10/sdk/native/jni/OPENCV.mk 


3836 工具 安装 


工具 编译 成 功 后 ， 会 生成 takeshot 可 执行 文件 和 prefvideo.apk 安 装 
文件 ， 而 prefvideo.apk 在 运行 过 程 中 快速 截屏 和 模拟 点 击 播放 按钮 都 是 
通过 takeshot 命 令 来 实现 的 。 所 以 这 里 需要 把 这 个 命令 复制 到 手机 系 
统 /system/bin 目 录 下 ， 并 改 为 可 执行 文件 。apk 的 安装 和 其 他 应 用 程序 
安装 相同 ， 这 里 就 不 做 介绍 了 。 下 面 是 可 执行 文件 的 安装 过 程 ， 具 体 
操作 如 下 : 


(1) 命令 takeshot 位 于 perfvideo 工 程 所 在 目录 libs\armeabi 下 ， 首 先 
通过 adb 命 令 push 到 手机 的 SD 存储 卡 上 ， 具 体 如 图 8-22 所 示 。 


E: project \iava\prefUideo\lihs\armeabi2adb push takeshot /sdcard/ 


i878 KB/s C17668 bytes in @.816s> 


图 8-22 ”文件 复制 到 SD 卡 目 录 
(2) 更 改 /system/bin 目 录 权 限 ， 如 图 8-23 所 示 。 


:project ava ‘prefUVUideo\libs\armeabi>adb shell 
sshell@cancro:/ 9 u 
Bt 


SAC 井 cd /System/hin 

d /system/bin 

"00tBcancro:/system/bin # mount -0 FW,.remount /system 
mount -0 Fy,.remount /system 


图 8-23 ”文件 从 SD 卡 复制 到 系统 目录 


(3) 把 两 个 命令 复制 到 /system/bin 目 录 并 更 改 为 可 执行 文件 ， 如 


图 8-24 所 示 。 


i127!1rYo00tB@cancro:/system/bin # cp /sdcard/takeshot . 
cp /sdcard/takeshot . 


TA ed chmod 772 takeshot 
chnod 772 takeshot 


图 8-24 ”更改 文件 为 可 执行 文件 


8.4 方案 优 缺 点 


前 面 介绍 了 相关 视频 首 帧 啊 应 时 间 目 动 化 测试 方案 ， 下 面 总 结 一 
下 本 方案 的 优 缺 点 。 


方案 优点 : 


独立 在 手机 中 运行 ， 不 需要 其 他 辅助 设备 。 
能够 目 动 且 精准 地 计算 出 首 帧 啊 应 时 间 。 
方案 缺点 : 

屏幕 截屏 和 注入 input 事 件 需 要 手机 ROOT 。 


测试 机 型 配置 一 般 需 要 4 核 及 以 上 和 2G 内 存 及 以 上 的 内 存 。 ( 主 
要 原因 是 机 型 配置 太 低 ， 快 速 截屏 可 能 会 影响 测试 结果 的 精准 度 ) 


8.5 ”本章 小 结 


本 草案 例 侧重 于 描述 视频 下 帧 啊 应 时 间 工 具 的 设计 ， 以 
Androidos4.4 系 统 下 QQ 浏 贞 磊 视频 首 帧 啊 应 时 间 为 例 ， 详 细 、 完 整地 
介绍 了 整个 方案 设计 思路 ， 并 对 设计 思路 中 的 关键 点 做 出 了 详细 分 析 
和 代码 实践 ， 对 于 读者 可 能 会 遇 到 的 共性 问题 也 做 了 详细 解释 。 怀 
外 ， 对 于 一 些 关 键 点 设计 思路 可 能 存在 多 种 实现 方案 ， 在 本 章 也 一 一 
列 出 ， 但 对 于 细节 没有 逐一 展开 ， 所 以 这 部 分 内 容 需 要 读者 目 行 练 
23]o 


本 章 内 容 比较 丰富 ， 涉 及 的 知识 点 也 多 。 通 过 本 章 阅 读 ， 相 信 读 
者 一 定 对 于 OPENCV 图 像 识别 技术 、FFMPEG 视 频 解码 技术 以 及 
Android 系 统 相关 源码 有 了 进一步 的 了 解 和 认识 。 此 方案 不 仅 适 合 浏 蜗 
器 网 页 视频 播放 测试 ， 也 适用 于 Android 系 统 下 任何 App 视 频 播放 器 响 
应 时 间 的 性 能 测试 ， 只 需要 针对 自己 的 产品 稍 做 变形 ， 就 可 以 实现 对 
应 的 测试 方案 。 


第 9 章 ”应 用 宝 BVT 测 试 采 例 


BVT (Build Verification Test) 测试 指 通过 上 自动 化 手段 ， 验 证 新 生 
成 的 软件 版 本 在 功能 上 是 否 完整 、 主 要 的 软件 特性 是 否 正确 。 在 项 目 
周期 短 、 版 本 快速 迭代 的 情况 下 ，BVT 测 试 可 以 快速 完成 对 新 版 本 的 
验证 工作 ， 避 免 低 质量 的 版 本 落 入 测试 人 员 手 中 ， 浪 费 人 力 ; 另外 ， 
日 党 的 BVT 测 试 还 可 以 起 到 监控 的 作用 ， 有 助 于 把 控 整 体 的 质量 风 
险 。 此 外 ， 应 用 宝 项 目 组 采用 FT (Feature Team) 模式 ， 整 个 项 目 组 分 
为 多 个 FT， 而 每 个 FT 又 同时 有 多 个 需求 分 文 在 并 行 运作 着 ， 几 乎 每 天 
都 有 新 特性 合 入 主干 ， 因 此 很 有 必要 将 分 文 合 流 前 rebase 测 试 、 合 流 后 
主干 验证 测试 等 环节 加 入 BVT 自 动 化 测试 ， 以 持续 验证 新 特性 未 破坏 
原 有 系统 。 


本 章 将 从 测试 工程 概 哎 、 测 试用 例 编写 、 测 试 报告 生成 、 跨 应 用 
处 理 、 测 斌 覆盖 率 度 量 等 维度 介绍 BVT 目 动 化 测试 在 应 用 宝 中 的 实际 
应 用 情况 。 第 一 小 节 介 绍 基于 Robotium 的 测试 工程 概览 ， 了 人 解 Android 
并 目 动 化 测试 的 动作 模式 。 第 二 小 市 介绍 基于 Robotium 测 试用 例 的 编 
写 ， 包 括 如 何 使 用 例 更 加 健壮 稳定 、 降 低 维 护 成 本 等 。 第 三 小 让 介绍 
结合 Spoon 测 试 报告 生成 ， 以 及 如 何 更 好 地 进行 出 错 重 试 与 截图 。 第 四 
小 世人 介绍 结合 UIAutomator2.0 版 本 进行 路 应 用 测试 。 最 后 介绍 测试 黎 兰 


率 的 度量 以 及 测试 效益 的 思考 。 本 章 知 识 结 构图 如 图 9-1 所 示 。 


一 测试 工程 | SN | TB 


用 例 生命 周期 
ee _ 上 用 例 编写 DR 网 
[一 测试 用 例 介绍 自动 化 测试 用 例 来 源 、 如 何 编写 、 如 何 执 行 、 如 何 管理 等 
Ee 
用 例 管 
出 错 重 试 与 截图 


应 用 宝 BVT 十 一 测 未 更 告 2 Tn van es 后 村 告 i 
测试 报 i uaana ， 让 报告 更 直观 

介绍 UIAutomator d 方式 

EE. RE 路 应 用 二 utomalor aump 让 工 


UIAutomator2.0 结合 Instrumentation 方式 


Jacoco 实践 


F=> 人 码 mi 证 率 
Has | 履 盖 率 数据 的 更 多 应 用 


em Jacoco 在 Android 端的 代码 覆盖 率 实 趾 


一 总 结 


图 9-1 ”本章 知 识 结构 图 


aa 用 解决 方案 


9.1 测试 工程 


9.1.1 测试 工程 概览 


使 用 Robotium 进 行 目 动 化 测试 ， 测 试 工程 为 一 个 Android Junit Test 
工程 ， 可 以 依赖 被 测 工程 ， 也 可 以 选择 独立 存在 。 如 果 需 要 引用 被 测 
工程 中 的 源码 ， 则 需要 在 测试 工程 的 Build Path 中 添加 对 被 测 工程 的 引 
用 ， 如 图 9-2 所 示 。 


会 Properties for NotepadTest 


|type filter text Java Build Path 

》 Resource 
Android 

Android Lint Preferences Required projects on the build path: 


| Source| 马 projects [a Libraries | “> Order and Export| 


Builders | b GS NotePad | | [ 
C Generation and Rever: 
Java Build Path 
》 java Code Style 
b Java Compiler 
Java Editor 


图 9-2 在 测试 工程 中 引用 被 测 工程 


关联 被 测 工程 源码 的 好 处 在 于 可 以 调用 被 测 工程 的 代码 ， 因 此 可 
以 更 容易 地 获取 被 测 应 用 内 部 的 状态 ， 例 如 拿 到 被 测 应 用 ListView 内 部 
填充 的 数据 等 。 而 这 样 也 会 市 来 一 些 泛 端 : 


测试 工程 的 目 动 化 编译 打包 也 需要 关联 被 测 工程 ， 脚 本 复杂 度 及 
维护 成 本 增加 。 


如 末末 用 R.id.xxx 方 式 获取 控件 的 话 ， 被 测 工程 增加 、 删 除 布 局 文 
件 都 可 能 影响 测试 工程 的 编译 结果 。 


-如果 被 测 应 用 进行 了 代码 混淆 ，3 引 用 被 测 工程 的 代码 复 洒 度 将 大 


鉴于 此 ， 应 用 宝 采 用 的 是 脱离 被 测 工程 的 方式 ， 同 一 份 测试 APK 
可 以 同时 测试 多 个 版 本 的 被 测 应 用 。 男 外 ， 即 使 大 家 选择 有 源码 的 方 
式 ， 也 不 建议 使 用 R.id.xxx 的 方式 获取 控件 。 


然后 ， 测 试 工 程 引用 Robotium 相 应 版 本 的 jar 包 即 可 ， 需 要 注意 的 
是 Robotium 这 个 jar 中 的 class 类 是 Android 手 机 中 未 存在 的 ， 因 此 在 Order 
and Export 中 需要 勺 先 上。 测试 工程 其 余 整 个 结构 与 Android 工 程 一 样 ， 
可 以 有 自己 的 布局 文件 、 资 源 文 件 等 。 此 外 ， 测 试 工程 需要 在 
AndroidManifest.xml 文 件 中 注册 Instrumentation 用 于 指定 被 测 应 用 ， 如 
下 面 的 代码 所 示 。 


<instrumentation 
android:targetPackage="com.robotium.android.notepad" 
android:name="android.test.InstrumentationTestRunner" /> 


在 同一 个 测试 工程 中 我 们 可 以 只 注册 一 个 mstrumentation， 也 可 以 
同时 注册 多 个 ， 例 如 当 被 测 应 用 有 多 个 ， 而 测试 工程 又 不 想 分 别 建 立 
时 ， 则 可 以 使 用 注册 多 个 的 方法 。 首 先 ， 编 写 一 个 继承 自 
android.test.InstrumentationTestRunner 的 自 定义 


InstrumentationTestRunner， 然 后 同样 地 在 AndroidManifest,xml 中 注册 ， 


如 下 面 的 代码 所 示 。 


<instrumentation 
android:targetPackage="com.robotium.android.anothernotepad" 
android:name=".instrumentation.InstrumentationTestRunner" /> 


9.2.1 测试 工程 签名 


由 于 测试 用 例 的 代码 在 运行 过 程 中 是 以 Instrumentation 注 入 的 方 
式 ， 和 被 测 应 用 在 同一 进程 ， 因 此 需要 测试 工程 与 被 测 工程 签名 一 
致 。 要 使 两 个 工程 釜 名 一 致 有 两 种 方式 ， 一 种 是 重 签名 被 测 工 程 ， 怀 
一 种 则 是 不 改变 被 测 工 程 ， 而 直接 使 用 被 测 工程 的 Key 等 名 测试 工程 。 


1. 重 签名 被 测 App 


当 进行 第 三 方 竞 品 测试 ， 无 法 获取 到 第 三 方 App 的 签名 Key 时 ， 可 
以 使 用 重 签名 的 方式 。 以 使 用 Android 中 的 debug.keystore 进 行 重 签名 为 
例 。 


(1) 解压 被 测 应 用 的 APK 文 件 。 
(2) 删除 其 中 的 签名 文件 META-INF 目 录 。 
(3) 重 压缩 ， 并 重 命 名 回 APK 文 件 。 


以 上 步骤 主要 目的 是 删除 原来 APK 文 件 里 的 签名 文件 META-INF 目 
孙 ， 即 去 挥 原 有 签名， 然后 在 命令 行 中 调用 JDK 中 的 jarsigner 工 具 进行 
签名 即 可 ， 代 码 如 下 : 


> jarsigner -verbose -keystore ~/.android/debug.keystore -storepass android 
-keypass android -signedjar applicationName_resigned.apk applicationName.apk 


androiddebugkey 


在 JDK7 及 以 上 环境 中 则 还 需要 增加 sigalg 和 digestalg 参 数 ， 代 码 如 
下 : 


> jarsigner -verbose -keystore ~/.android/debug.keystore -storepass android 
-keypass android sigalg MD5withRSA digestalg SHA1 -signedjar applicationName_ 
resigned.apk applicationName.apk androiddebugkey 


这 里 的 debug.keystore 位 于 C: \Users 相 应 用 户 名 下 的 .android 目 条 
中 ， 测 试 工程 在 Eclipse 中 默认 使 用 的 也 是 这 个 debug.keystore， 因 此 被 
测 工 程 也 使 用 debug.keystore 签 名 后 ， 两 者 的 签名 就 一 致 了 。 


2. 签 名 测试 App 


在 实际 项 目 中 ， 如 末 古 目 己 的 项 目 ， 显 然 古 不 布 户 对 人 被 测 App 进 行 
重 等 名 的 ， 原 因 如 下 : 


:每 日 进行 测试 的 包 众 多 ， 一 一 进行 重 签名 影响 效率 。 


-如 微 信 、 应 用 至 等 应 用 做 了 签名 防护 措施 ， 重 签名 后 将 导致 应 用 
部 分 功能 不 可 用 甚至 直接 无 法 局 动 。 


因此 ， 目 己 的 项 目 可 以 拿 到 被 测 工 程 的 签名 Key， 使 用 该 Key 对 测 
试 工程 进行 签名 即 可 ，Eclipse 中 稚 认 编 详 出 来 的 测试 APK 使 用 的 十 


debug.keystore， 可 以 在 “Preferences 一 Android 一 Build” 中 设置 为 使 用 被 
测 工 程 的 keystore， 如 图 9-3 所 示 。 


这 样 即 可 在 不 改变 被 测 应 用 的 情况 下 ， 对 被 测 应 用 进行 测试 。 此 
外 ， 我 们 肯定 不 希望 目 动 化 测试 借用 Edlipse 进 行 编译 、 打 包 、 签 名 ， 
而 是 希望 测试 代码 也 可 以 持续 集成 起 来 ， 因 此 有 必要 使 用 构建 工具 如 
ant 进 行 编译 、 打 包 、 签 名 。 由 于 测试 工程 结构 与 普通 的 Android 项 目 一 
致 ， 网 上 资料 也 较 多 ， 因 此 测试 工程 使 用 ant 进 行 编译 、 打 包 、 签 名 在 
这 束 不 再 玖 述 了 。 


ltype filter text | Build 


b General Build Settings: 
4 Android 


Build | 网 Automatically refresh Resources and Assets folder on build 
ui 


加 
DDMS [VY] Force error when external jars contain native libraries 


Editors 贺 Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output 
Lint Error Checkind ® Silent 
”LogCat © Normal 
NDK © Verbose 


Usage Stats 
区 ik Default debug keystore: CC: \Users\Administrator\.android\debug. .keystore 


”C/C++ MD5 fingerprint: 31:CB:CD:98:67:32:6A:F8:FD:39:FB:E1:13:D2:E9:59 
b Code Recommenders 

a SHA1 fingerprint: BA:06:5D:4B:25:DC:9F:25:17:B4:;07:0F:A7:3D:D5;43:4D:98:69:01 
b Ecore Diagram 


b Help | Custom debug keystore: E: re 


by Install/lUpdate a > 
b Java Wer 


b Maven | SHA1 fingerprint: 


图 9-3 ”测试 工程 使 用 目 定义 的 keystore 


9.2 测试 用 例 


9.2.1 测试 用 例 生 命 周 期 


测试 用 例 基于 Android Junit， 每 个 用 例 遵 循 下 面 三 个 步骤 。 
(1) 执行 setUp 〈) 方法 ， 用 于 初始 化 。 
(2) 执行 以 public 且 方法 名 以 test 开 头 的 用 例 方 法 。 
(3) 执行 tearDown () 方法 ， 用 于 释放 资源 等 。 


如 代码 清单 9-1 所 示 ， 用 例 先 对 构造 函数 进行 初始 化 ， 通 过 反射 机 
制 获 取 了 要 启动 的 Activity 类 名 ， 然 后 开始 进入 用 例 的 生命 周期 。 先 执 
行 setUp () 方法 ， 并 实例 化 Solo 对 象 ，new Solo (getInstrumentation 
() ，getActivity () ) 中 的 第 二 个 参数 为 调用 的 基 类 
ActivityInstrumentationTestCase2 中 的 getActivity () 方法 ， 如 果 指 定 的 
Activity 坟 启动， 将 通过 Intent 噶 起 该 Activity。 随 后 ， 开 始 执行 
testAddNote () 方法 ， 进 行 实际 的 自动 化 测试 。 最 后 ， 调 用 tearDown 
() 方法 ，solo.finishOpenedActivities () 将 关闭 所 有 已 打开 的 
Activity， 完 成 一 个 完整 的 用 例 测试 过 程 。 


代码 清单 9-1 ”基于 apk 测 试 示例 


package com.robotium,test 
import android,test.ActivityInstrumentationTestCase2 
import com.robotium.solo.Solo; 
public class NotePadTest extends ActivityInstrumentationTestCase2f{ 
private static final String LAUNCHER _ ACTIVITY_FULL_CLASSNAME = 
"com.robotium.android.notepad.NotesList"; 
private static Class launcherActivityClass,; 
static{ 
try 
{ 
launcherActivityClass=Class.forName(LAUNCHER_ACTIVITY_FULL_CLASSNAME); 
} catch (ClassNotFoundException e){ 
throw new RuntimeException(e); 
} 
} 
private static final String TAG = NotePadTest.class.getSimpleName(); 
private Solo solo; 
public NotePadTest() { 
super(launcherActivityClass); 
} 


QOverride 
public void setUp() throws Exception { 
//setUp() is run before a test case is started., 
//This is where the solo object is created. 
super ,SetUp() ; 
Solo = new Solo(getInstrumentation(), getActivity()); 
} 
QOverride 
public void tearDown() throws Exception { 
//tearDown() is run after a test case has finished. 
//finishOpenedActivities() will1 finish all the activities that have been 
opened during the test execution. 
solo.finishOpenedActivities(); 
solo = null; 
super ,tearDown( ) ， 
} 
public void testAddNote() throws Exception { 
//Unlock the lock screen 
solo.unlockScreen(); 
solo.clickOnMenuItem("Add note"); 
//Assert that NoteEditor activity is opened 
solo.assertCurrentActivity("Expected NoteEditor activity", "NoteEditor"); 
//In text field 0, enter Note 1 
solo.enterText(0, "Note 1"); 
solo.goBack( ); 
//Clicks on menu item 
solo.clickOnMenuItem("Add note"); 
//In text field 0, type Note 2 
solo.typeText(0, "Note 2"); 
//Go back to first activity 
SO]1o ,goBack( ) ， 
//Takes a Screenshot and saves it in "/sdcard/Robotium-Screenshots/". 
So]1o ,takeScreenshot ( ) ， 
boolean notesFound = solo.searchText("Note 1") && solo.searchText("Note 
2"); 
//Assert that Note 1 & Note 2 are found 
assertTrue("Note 1 and/or Note 2 are not found", notesFound); 


9.2.2 ”测试 用 例 编写 

测试 用 例 编写 的 质量 直接 关系 到 用 例 的 稳定 性 、 维 护 成 本 以 及 是 
否 能 发 现 有 效 问 题 等 ， 因 此 是 自动 化 测试 中 的 关键 一 环 。 

首先 ， 确 定 测 试用 例 的 来 源 。 


当 开 始 准备 编写 自动 化 测试 用 例 时 ， 需 要 确定 测试 用 例 的 来 源 ， 
即 需要 明确 以 下 几 个 方面 : 


:哪些 功能 是 主要 功能 ， 哪 些 功 能 可 以 目 动 化 。 
:用 例 的 优先 级 、 作 用 的 测试 阶段 。 
测试 一 个 功能 需要 哪些 验证 点 。 


不 同 的 项 目 组 需要 思考 的 点 可 能 不 一 样 ， 但 目的 是 一 致 的 ， 需 要 
明确 测试 用 例 的 来 源 ， 而 不 是 任意 地 开始 编写 用 例 。 应 用 宝 中 采用 
CheckList 的 形式 ， 通 过 与 各 业务 线 讨 论 评审 的 方式 确定 关键 功能 、 是 
否 目 动 化 、 用 例 优 和 级 、 测 试验 证 点 等 ， 如 图 9-4 所 示 


ID 用 贷 名 称 


76756390 EB 插件 动态 下 发 -更 新 


76756388 EB 插件 动态 下 发 -下 载 
76754205 GEB 搜索 直达 区 内 容 外 显 
76736565 BB 小 米 攻防 卡 


76736563 EGB 管理 -辅助 功能 


图 9-4 确认 测试 用 例 来 源 


明确 了 测试 用 例 的 来 源 后， 一 个 用 例 的 步骤 及 验证 点 就 基本 确定 
了 


其 次 ， 应 该 合理 地 去 设计 目 动 化 测试 用 例 。 


接 下 来 本 小 节 将 通过 代码 清单 9-2 中 的 示例 从 工程 角度 及 用 例 设 计 
角度 来 介绍 BVT 自 动 化 测试 用 例 的 编写 。 


代码 清单 9-2 ”BVT 测试 用 例 示例 


二 
* 测试 从 下 载 管理 页 中 下 载 安装 应 


</br></br> 


* 工 , 查 看 下 载 管理 页 中 是 否 有 下 载 任务 ， 没 有 的 话 则 从 发 现 频道 中 添加 一 个 


</br> 
* 2 ,进入 下 载 任务 管理 页 ， 点 击 下 载 任务 中 的 “继续 按钮， 继续 下 载 并 安装 应 


</br> 
* 3 ,断言 应 用 是 否 安装 成 功 ， 断 言 安装 成 功 后 ， 下 载 按钮 状态 是 否 变 为 “打开 ” 


</br> 
* 4 ,为 确保 后 面 的 测试 ， 会 卸载 该 应 


</br> 
*/ 
public void test76410589_ Download_ FromTaskList_ ShouldInstallSucessful(){ 


operation.deleteAllDownloadTasks(); 
// 若 测试 前 下 载 任务 为 空 ， 则 先 添加 一 个 


if(operation.isDownloadPageEmpty()){ 
operation.addDownloadTaskFromTab(); 
operation.sleepwait(); 


operation.enterDownloadActivity(); 
DownloadTaskListIitem downloadTaskListItem = 
operation.getDownloadTaskListItemByIndex(0); 
TextView downloadButton = downloadTaskListItem.getDownloadButton(); 
appName = downloadTaskListIitem.getAppName().getText().tostring(); 
if(!downloadButton.getText().tostring().equals(YYBConstant.STAT_OPEN) 
&& !downloadButton.getText().toString().equals(YYBConstant.STAT_PAUSE)){ 
solo.clickOnView(downloadButton); 
operation.sleepwait(); 


} 

operation.waitForTextStat(downloadButton, YYBConstant.STAT_INSTALLING, 
TimeUtils.THREE_MINI); 

operation.waitForTextStat(downloadButton, YYBConstant.STAT_OPEN, 
TimeUtils.ONE_ MINI); 

operation.sleepwait(); 

LogUtils.1logD(TAG, "isAppInstalled after install:" + 
operation,isAppInstalled(appName ) ) ， 

assertTrue(appName + "应 该 要 安装 到 手机 上 了 


", operation.isAppInstalled(appName)); 
operation.assertDownloadBtnSstat (downloadButton, YYBConstant .STAT_OPEN); 
operation.sleepwait(); 
operation.uninstallByAppName (appName ) ， 
operation.goBackToMainActivity(); 


在 设计 自动 化 测试 用 例 时 ， 除 了 实现 用 例 来 源 中 的 功能 步骤 外 ， 
用 例 的 原子 性 是 需要 特别 注意 的 ， 这 将 影响 到 多 个 用 例 在 一 起 时 是 否 
可 以 高 效 稳定 地 运行 。 用 例 的 原子 性 ， 即 用 例 间 应 该 保持 相对 独立 ， 
不 因 用 例 执行 的 先后 顺序 而 彼此 干扰 。 如 代码 清单 9-2 所 示 ， 
deleteAllDownloadTasks () 方法 用 于 初始 化 环境 ， 清 空 原 有 的 管理 页 
中 的 任务 列表 ， 避 免 先前 执行 的 用 例 对 该 用 例 造 成 影响 。 然 后 常规 地 
实现 了 用 例 来 源 中 的 步 又 功能 ， 自 动 添加 了 一 个 下 载 任务 ， 进 入 下 载 
管理 页 ， 下 载 并 安装 应 用 。 最 后 ， 为 了 保持 用 例 的 原子 性 ， 执 行 完 该 


用 例 后 不 影响 接 下 来 的 用 例 ， 因 此 调用 uninstallByAppName 
(appName) 方法 将 刚才 安装 的 应 用 种 载 。 


再 次 ， 应 该 以 工程 的 视角 去 看 竺 测试 用 例 。 


测试 代码 也 应 该 以 工程 的 视角 去 看 待 ， 包 括 配置 管理 、 结 构 管 
理 、 项 目 化 运作 等 。 在 编写 测试 用 例 过 程 中 也 应 该 尽 可 能 地 从 工程 角 
度 在 代码 易 用 性 、 维 护 性 方面 多 加 考虑 。 


1. 依 赖 与 硬 合 


耦合 度 就 是 某 模 块 (类 ) 与 其 他 模块 (类) 之 间 的 关联 、 感 知 和 
依赖 的 程度 ， 是 衡量 代码 独立 性 的 一 个 指标 。 在 耦合 度 很 高 的 情况 
下 ， 维 护 代 码 时 修改 一 个 地 方丈 会 牵连 到 很 多 地 方 ; 而 相反 地 ， 如 果 
硝 合 度 很 低 ， 往 往 又 意味 着 重复 代码 多 ， 如 同一 盘 散 沙 ， 难 以 维护 。 
因此 ， 需 要 平衡 依赖 与 耦合 之 间 的 关系 ， 让 代码 稳定 、 健 壮 且 易于 维 
扩 。 


在 测试 代码 中 ， 和 常常 有 一 些 步骤 是 许多 用 例 都 需要 执行 的 ， 那 么 
就 应 该 将 这 些 通用 的 步 又 提取 出 来 ， 作 为 公共 的 方法 ， 且 这 个 方法 需 
要 确保 有 足够 的 稳定 性 ， 因 为 它 的 健壮 与 否 ， 关 系 到 多 个 用 例 的 健壮 
性 。 如 代码 清单 9-3 所 示 ， 除 了 solo 常 规 的 操作 方法 外 ， 在 业务 上 将 常 
用 的 一 些 跳 转 步 怠 、 环 境 构 千 、 业 务 层 的 断言 等 进行 封 狠 。 统 一 封 浅 
了 进入 下 载 管理 页 的 方法 ， 每 个 用 例 在 需要 进入 该 页 面 时 调用 


enterDownloadActivity () 方法 即 可 ， 而 如 果 跳 转 至 该 页 面 的 UI 有 变 
动 ， 则 仅 需 修改 该 方法 。 此 外 ， 代 码 中 通过 ViewId 和 常量 类 来 统一 管理 
控件 ID ， 避 免 UI 变 动 时 到 处 修改 测试 用 例 。 


从 依赖 与 耦合 的 角度 看 ， 但 凡 测 试 代码 中 有 重复 的 地 方 ， 均 应 该 
将 其 握 取 封装， 并 确 你 封 竣 方 法 的 稳定 性 ，Selenium 中 使 用 的 
PageObject 模 式 也 是 基于 这 样 的 目的 的 。 


代码 清单 9-3 ”测试 用 例 中 对 跳 转 统一 封 婆 


大 
* 下 载 管理 


</br> 
* @return 
*/ 


public boolean enterDownloadActivity(){ 
checkIsMainActivity(); 
RelativeLayout mBtnDownload = 
(RelativeLayout)solo.getView(ViewId.mybtndownload); 
solo.clickOnView(mBtnDownload); 
sleeper.sleepwait(); 
return isExpectedActivity(YYBConstant ,DOWNLOAD_ACTIVITY ) ， 
和 


2. 面 问 对 象 的 控件 获取 方式 


由 于 应 用 宇 中 的 控件 很 多 是 以 列表 Item 形 式 存在 的 ， 在 每 个 Item 
中 ， 应 用 名 、 应 用 大 小 、 下 载 按钮 等 的 控件 ID 在 不 同 的 界面 中 均 是 相 
同 的 ， 且 也 不 希望 用 例 代 码 中 包含 大 量 ID 名 。 因 此 ，BVT 用 例 在 获取 
控件 时 采用 的 是 面向 对 象 的 方式 ， 如 代码 清单 9-4 所 示 ， 将 列表 中 一 个 


Child 中 的 多 个 控件 封装 成 一 个 SimpleApp 对 象 ， 测 试用 例 中 就 不 再 需要 
关心 控件 的 细节 了 ， 加 快 了 用 例 的 编写 速度 并 降低 了 维护 成 本 。 


代码 清单 9-4 测试 用 例 面 问 对象 的 获取 控件 方式 


public SimpleApp getSimpleApp(RelativeLayout relativeLayout ){ 
SimpleApp simpleApp = new SimpleApp(); 
simpleApp = pieceSimpleApp(relativeLayout); 
simpleApp.setAppTitle( (TextView) 
relativeLayout.findViewById(holo.getId(ViewId.title))); 
if(simpleApp.getAppTitle() == null){ 
LogUtils.1logD(TAG, "title is special"); 
simpleApp.setAppTitle( (TextView) 
relativeLayout.findViewById(holo.getId(ViewId.app_name_ txt))); 
} 


return simpleApp; 


当然 ， 测 试 代码 也 应 该 有 代码 规范 ， 包 含 命名 规范 、 编 写 规范 、 
注释 规范 等 ， 以 使 测试 用 例 能 高 效 、 有 质量 地 运转 起 来 。 


最 后 ， 应 该 验证 测试 用 例 的 有 效 性 。 


自动 化 测试 用 例 本 喘 也 是 需要 经 过 验证 与 测试 的 ， 一 个 测试 用 例 
本 喘 运行 通过 了 并 不 一 定 代表 用 例 束 是 有 效 的 。 例 如 可 能 因为 检查 后 
判断 有 问题 导致 该 用 例 始终 通过 ， 而 一 般 当 用 例 开始 交付 运行 后 ， 如 
果 一 直 十 通过 的 ， 那 么 往往 整 不 会 再 有 人 关注 ， 且 测试 人 员 会 认为 该 
模块 已 经 有 目 动 化 测试 去 保障 ， 从 而 容易 忽略 基本 的 测试 ， 所 以 往往 
无 效 的 目 动 化 测试 用 例 比 没有 目 动 化 测试 的 测试 用 例 更 可 怕 ， 需 要 和 警 


惕 出 现 无 效 的 测试 用 例 。 在 编写 测试 用 例 时 需要 验证 用 例 的 有 效 性 ， 
在 测试 用 例 交 付 使 用 后 ， 也 应 该 定期 地 关注 测试 用 例 的 运行 情况 及 其 
有 效 性 。 


9.2.3 测试 用 例 执行 


以 Eclipse 为 例 ， 运 行 测试 用 例 时 选择 需要 执行 的 用 例 类 ， 者 已 配 
置 Run Configuration， 则 右 击 Run As 选择 Android Junit Test 即 可 。 若 还 
未 配置 Run Configuration， 则 右 击 Run As 一 -Run Configuration 进 行 配 
置 ， 可 以 设 定 要 执行 的 类 名 及 Instrumentation runner 等 ， 如 图 9-5 所 示 。 


Create, manage, and run configurations 


Android JUnit Test 


ER ET 
呈 葵 其 | 加 和 7 Name: AppTabListTest 


typo fitor toxt es Target| © Common| 


a] ; 
Jy AppTablistTest @ Run a single test 
JH Ass'stantTabActvity2Tost 


9 3 ) 
JJ AssistantTabActivityTest Project: QQDownloaderTest a | 
JD AssistantTabActivityTcst (2] 引 Test dass: com.tencent.assistant.qa.admonitor AppTablistTest Searchs | 
J AssistantTabActivityTest.test Mg [ 


J AuthorOtherAppsActivityTest 
区 AuthorOthcrAppsActivityTest (1 © Run all tests in the selected project or package 
.向 BackgroundCpuTest 
8 BackgroundSetUpTest 
nH BookStoreTest 


J CallActivityTest Instrumentation runner com.tencent,tesly,sdkjumitreportJUnmitiReportTestRunner 
q A 

JU CellActvityTest (1) Only run test methods annotated with: |Alljests 

9 CollActivityTest (2) 

机 CardTest @SmalTest 

J CardTest (1) @MediumTest 

8 ChangeNetworkTest WLlargelest 


图 9-5 ”Run Configuration 配 置 


除了 在 IDE 中 运行 测试 用 例外 ， 也 可 以 使 用 adb 命 令 行 方式 运行 测 
试用 例 。 基 于 Instrumentaion 的 测试 用 例 可 以 使 用 android.test 包 下 的 


InstrumentationTestRunner 张 动 执 行 。 命 令 行 方式 为 : 


$ adb shell am instrument -w <test_package _ name>/<runner_class> 


主要 参数 说 明 见 表 9-1 。 


表 9-1 主要 参数 说 明 


说 明 
在 测试 工程 的 AndroidManifest 中 定义 的 自身 包 名 


例如 Android、Test、InstrumentationTestRunner 


<test package> 


| ”测试 工程 的 包 名 


使 用 的 test runner 


类 名 


<runner class -og 


am instrument 的 标志 位 说 明 见 表 9-2 。 


表 9-2 am instrument 的 标志 位 说 明 


标志 值 说 明 

-W 万 强制 am instrumentation 等 待 直至 Instrumentation 运行 完成 ， 这 个 标志 位 的 作 
用 在 于 ， 如 果 不 使 用 该 选项 ， 则 控制 台 未 等 用 例 执行 结束 即 已 退出 ， 那 样 不 方便 
从 控制 台中 看 到 测试 结果 


-I 天 输出 执行 过 程 中 的 原始 信息 ， 该 标志 位 是 为 性 能 测量 而 设计 的 ， 常 与 -e perf 
true 参数 同时 使 用 
-e <test_options> 提供 键 值 对 形式 的 参数 选项 ， 可 提供 多 个 参数 选项 


am instrument 的 主要 参数 选项 见 表 9-3。 


表 9-3 am instrument 的 主要 参数 选项 


键 值 说 明 
package <Java_package name> 站 定 要 执行 的 包 
class <class_name> 指定 要 执行 的 类 
<class_name>#method name 指定 要 执行 的 某 个 类 中 的 方法 

size [small | medium |large] 执行 的 带 有 指定 注解 的 用 例 ， 注 解 可 以 是 @SmallTest、@ 
MediumTest 或 @LargeTest 

debug true 设置 是 否 以 debug 模式 运行 用 例 

perf true 设置 是 否 运 行 实现 了 PerformanceTestCase 的 用 例 ， 当 使 用 

交 选 项 时 ， 一 般 也 同时 开启 了 -r 标志 位 ， 以 输出 原始 信息 

EMMA true 设置 是 否 开启 使 用 EMMA 收集 代码 覆盖 率 ，EMMA 输出 
的 默认 路 径 为 /data/<app_package>/coverage.ec， 也 可 以 通过 
coverageFile 选项 指定 路 径 。 需 要 注意 的 是 ， 开 启 该 选项 的 前 
提 是 ， 被 测 应 用 构建 打包 时 需要 为 EMMA-instrumented 的 包 

coverageFile <filename> 指定 EMMA 输出 的 路 径 


通过 am instrument 的 各 参数 选项 的 组 合 ， 可 以 灵活 指定 要 执行 的 测 
斌 用例， 例如 : 


执行 单个 类 里 的 某 个 指定 用 例 代 码 如 下 : 


$ adb shell am instrument -w -e class com.android.foo.FooTest#testFoo com. 
android.foo/android.test.InstrumentationTestRunner 


执行 多 个 类 中 的 所 有 用 例 代码 如 下 : 


$ adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo. 
TooTest com.android.foo/android.test.InstrumentationTestRunner 


编译 打包 时 使 用 EMMA 进 行 插 桩 ， 当 需要 自动 化 用 例 收集 代码 窄 
次 率 时 ， 可 以 使 用 如 下 命令 开局 : 


$ adb shell am instrument -w -e coverage true coverageFile /sdcard/myFile.ec 
class com.android.foo.FooTest,com,.android.foo.TooTest com.android,.foo/android. 
test.InstrumentationTestRunner 


将 coverage 设 置 为 true 后 ， 运 行 完 目 动 化 用 例 ， 将 会 在 /sdcard 目 有 
下 生成 myFile.ec 文 件 ， 再 通过 EMMA 工 具 可 以 生成 覆盖 率 报 告 ， 代 码 
履 盖 率 相关 知识 可 以 参见 9.5 节 ， 将 有 更 详细 的 介绍 。 


9.2.4 测试 用 例 管理 


当 编 写 了 较 多 测试 用 例 时 ， 束 需要 将 测试 用 例 进行 分 类 管理 ， 以 
方便 统一 维护 及 用 例 分 级 。 基 于 Junit 的 测试 可 以 使 用 TestSuite 的 方式 
进行 管理 ， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 ”使 用 TestSuite 的 方式 进行 用 例 管 理 


public class ExampleTestSuite extends TestSuitet 
public static Test suite() { 
TestSuite tsSuite = new TestSuite(); 
tsSuite.addTestSuite(GameTabActivityTest.class); 
tsSuite.addTest(TestSuite.createTest(AppTabActivityTest.class, 
"testFoundTab_CheckQuickEntry")); 
return tsSuite,; 
} 


} 


由 于 在 测试 执行 时 ， 不 同 的 用 例 执行 时 间 长 短 不 同 ， 且 作用 的 测 
试 阶段 也 各 不 相同 ， 因 此 在 进行 用 例 管理 时 ， 需 要 明确 用 例 的 级 别 ， 
例如 区 分 有 是 核心 功能 用 例 还 是 普通 用 例 ， 从 而 将 不 同 级 别 的 用 例 放 于 
一 处 进行 管理 ， 在 执行 时 才 可 以 有 针对 性 地 进行 测试 。 


9.3 测试 报告 
9.3.1 Spoon 介绍 


Spoon 是 一 个 主导 有 okhttp、retrofit、leakcanary 等 众多 优秀 开源 项 
目的 Square 公司 在 GitHub 上 的 开源 项 目 ， 致 力 于 改善 基于 
Instrumentation 的 测试 。 通 过 分 布 式 地 在 多 部 手机 上 同时 执行 基于 
Instrumentation 的 测试 用 例 ， 并 且 在 测试 完成 后 生成 统一 的 拥有 测试 结 
采 概 哎 、 截 图 、 运 行 时 日 志 等 功能 的 HTML 形 式 测试 报告 ，Spoon 可 以 
更 加 快速 、 有效 地 对 Android 终 端 进行 目 动 化 测试 。 


项 目 开 源 地 址 : https://github.com/square/spoon 。 


测试 报告 可 以 方便 地 看 到 哪个 用 例 在 哪 部 手机 上 执行 失败 ， 结 
概览 如 图 9-6 所 示 。 


Spoon Sample App 全 


45 tests run across 5 Gevices with 30 passing and 15 failing in 2 minutes. 33 seconds at 2013-01-17 D604 PM 


图 9-6 多 机 同时 执行 后 的 测试 结果 概 抠 


测试 报告 包含 执行 过 程 中 的 截图 ， 如 图 9-7 所 示 。 


Rn On 5 feoes wl 2 0953 


HTC OneV 


9 tests fun wt 6 possng rd 3 fing in 0 seconds Wt 001300.17 0604 PM 


Make Some Salad, It Is Heaithy 


图 9-7 用 例 执 行 过 程 中 的 截图 


测试 报告 也 包含 每 个 用 例 的 运行 时 日 志 ， 如 图 9-8 所 示 。 


Test errored in D se 


Timestamp Level 
02-12 10:28:19.560 info 
02-12 10.28.19.623 dcbug 
02-12 10:28.19.701 debug 
02-12 10:2819701 info 
02-12 10:28.19.701 info 
02-12 10:28:19.716 info 
02-12 10:28:19.715 info 
02-12 10:28:19.716 info 
02-12 10:28:19.716 info 
02-12 10:28:19.716 info 
02-12 10:28:19.716 
02-12 10:28:19.716 info 
02-12 10:28:19.716 info 
02-12 10:28:19.716 info 
02-12 10:28.19 7T6 Info 


info 


Another Long Name Because lt ls 人 


Humorous And Testing Things Like This ls 
Important 


nds on Drox 


Tag Message 

TestRunner started: lestAnotherLongNameBecauseltlsHumorousAndTestingThingsLikeThislsImportant(com example spoon ordering tests Miscellaneous1 
dalvikym GC_EXPLICIT freed 996 objects / 124856 bytes in 62! 
dalvikvm GC_EXPLICIT freed 14 objects / 588 bytes in 7TOms 


TestRunner failed: testAnotherLongNameBecauseltisHumorousAndTestingThingsLikeThislsiImportant(com example spoon ordering tesis.MiscellaneousTe 


ms 


TestRunner ----- begin exception ----— 
TestRunner java.lang.lllegalStateException: Explicitly testing unexpected, nested exceptions. 

TestRunner atcom.example.spoon ordering tests. MiscellaneousTest.testAnotherLongNameBecauseltisHumorousAndTestingThingsLikeThisisimportant(M 
TestRunner atjava.lang.reflect.Method invokeNative(Native Method) 

TestRunner atjava.lang.reflect.Method invoke(Methodjava:521) 

TestRunner atandroid.test.InstrumentationTestCase.runMethod(Instrumentation TestCase java:204) 

TestRunner atandroid test InstrumentationTestCase runTest(InstrumentationTestCase java: 194) 

TestRunner atjunit.framework.TestCase.runBare(TestCase.java:127) 

TestRunner atjunit.framework.TestResult$1.protect(TestResultjava:106) 

TestRunner atjunit.{ramework.TestResult.runProtected(TestResult.java:124) 


TestRunner atjunit framework TestResult run(TestResult java:109) 


图 9-8 用例 的 运行 时 日 志 


通过 Spoon 来 执行 基于 Instrumentation 的 测试 用 例 ， 可 以 很 方便 地 


生成 富 于 展示 的 测试 报告 ， 通 
定位 用 例 失 败 的 原因 。 此 外 ， 在 报告 中 的 junit-reports 目 录 下 ， 


快速 


过 报告 中 运行 时 截图 及 运行 时 日 志 可 以 


生成 有 基于 Junit 格 式 的 xml 报 告 ， 可 以 通过 解析 该 目 邓 下 的 xml 报 告 获 


得 详细 的 包括 用 例 执行 总 数 、 用 例 通 
行 时 间 等 数据 ， 


通过 上 文 的 介 
Spoon 执 行 并 生成 测试 报告 ， 而 Robotium 框 架 编写 的 测试 用 例 就 是 基 


过 总 数 、 用 例 失 败 总 数 、 用 例 执 
以 方便 地 进行 测试 数据 统计 。 


绍 可 知 ， 基 于 Instrumentation 的 测试 用 例 都 可 以 通过 
于 


Instrumentation 的 ， 因 此 两 者 可 以 很 好 地 进行 结合 以 达到 增强 测试 报告 
精准 度 的 目的 。 


测试 报告 通过 调用 Spoon Runner 的 jar 包 执行 测试 后 生成 ， 使 用 方法 
为 java-jar 命 令 行 方式 ，Spoon Runner 的 主要 参数 如 代码 清单 9-6 所 示 。 


代码 清单 9-6 ”Spoon Runner 的 主要 参数 


Options: 

--apk 被 测 
APK 包 所 在 的 路 径 

--fail-on-failure 当 出 现 


failure 时 ， 发 现 非 


0 的 退出 码 
--Output 测试 报告 的 输出 路 径 ， 默 认为 
spoon-output 
--Sdk Android SDK 的 路 径 ， 若 已 配置 可 不 填 
--test-apk 测试 
APK 的 路 径 
--title 测试 报告 显示 的 标题 
--class-name 测试 用 例 类 名 ， 需 要 为 带 包 名 的 全 称 
--method-name 测试 用 例 方法 名 
--no-animations 禁止 进行 截图 的 
gif 生 成 
--Size 只 运行 包含 相应 注解 的 用 例 


(small、 


medium、 


large) 
--adb-timeout 设置 每 个 用 例 支持 的 超时 时 间 (默认 为 


40 分 钟 ) 


在 执行 时 需要 指定 被 测 的 APK 及 测试 APK 所 在 的 路 径 ， 还 需要 指 
定 测试 用 例 名 等 参数 。 在 执行 时 ，Spoon 会 自动 将 被 测 APK 与 测试 APK 
安装 至 手机 ， 代 码 如 下 (示例 中 使 用 的 %apkpath% 为 参数 ， 实 践 中 需 
替换 为 实际 的 路 径 ) : 


java -Dencoding=UTF-8 -Dfile.encoding=UTF-8 -jar spoon-runner-1.1.3-SNAPSHOT- 
jar-with-dependencies,.jar --title "YYB Continuous Integration Regression Test" 
--apk %apkpath% --test-apk %testapk_path% --class-name %test_class% 


测试 完成 后 将 在 spoon-output 目 录 下 生成 如 图 9-9 所 示 的 目录 结构 ， 
此 报告 为 HTML 形 式 的 静态 报告 ， 通 过 Web 服 务 絮 即 可 对 外 提供 访问 。 


名 称 


device 


) image 


) Junit-reports 
logs 
static 
! test 
@ index.html 
硬 resultjson 
@ tv.html 


图 9-9 ”spoon-output 报 告 的 目录 结构 


9.3.2 ”结合 Spoon 的 出 销 重 试 与 截 


在 编写 用 例 过 程 中 ， 会 有 以 下 需求 点 : 
用 例 失 败 时 可 以 即时 重 坛 ， 避 免 过 多 的 误 报 情况 。 


用例 失败 时 可 以 包含 执行 过 程 中 的 截图 ， 便 于 根据 当时 场景 定位 


问题 。 


完 来 看 看 失败 重 试 的 实现 ， 测 试 基 类 InstrumentationTestCase 继 承 
和 目 Junit 中 的 TestCase， 采 用 的 也 是 通过 runTest () 方法 适 配 各 个 Test 的 
模式 。 在 runTest () 中 ， 规 定 了 测试 用 例 需要 为 public 的 Method。 此 
外 ， 通 过 @FlakyTest (tolerance=3) 注解 的 形式 ， 当 测试 用 例 失 败 时 
会 进行 重 试 ， 重 试 次 数 由 tolerance 的 值 指 定 。 如 代码 清单 9-7 所 示 。 


代码 清单 9-7“” InstrumentationTestCase 中 的 runTest () 源码 实现 


A/ 
* Runs the current unit test. If the unit test is annotated with 
* {@link android.test.UiThreadTest}, the test is run on the UI thread. 
Wp 
Q@Override 
protected void runTest() throws Throwable { 
String fName = getName( ); 
assertNotNull(fName); 
Method method = null; 
try { 
// use getMethod to get all public inherited 
// methods. getDeclaredMethods returns all 
// methods of this class but excludes the 
// inherited ones. 
method = getCclass().getMethod(fName, (Class[]) null); 
} catch (NoSuchMethodException e) { 


// 


pu 


fail("Method \""+fName+"\" not found"),; 


判断 方法 是 否 是 


blic 的 
if (!Modifier.isPublic(method.getModifiers())) { 
fail("Method \""+fName+"\" should be public"); 
int runCount = 1; 
boolean isRepetitive = false; 
if (method.isAnnotationPpresent(FlakyTest.class)) { 
runCount = method.getAnnotation(FlakyTest.class).tolerance(); 
} else if (method.isAnnotationpresent(RepetitiveTest.class)) { 
runCount = method.getAnnotation(RepetitiveTest.class).numIterations(); 
isRepetitive = true; 
If (method.isAnnotationPresent(UiThreadTest.class)) { 
final int tolerance = runCount,; 
final boolean repetitive = isRepetitive,; 
final Method testMethod = method; 
final Throwable[] exceptions = new Throwable[1]; 
getInstrumentation().runonMainSync(new Runnable() { 
public void run() { 
try { 
runMethod(testMethod, tolerance, repetitive); 
} catch (Throwable throwable) { 
exceptions[0] = throwable,; 
} 
} 
}); 
if (exceptions[0] != null) { 
throw exceptions[0]; 
} 
} else { 
runMethod(method, runCount, isRepetitive); 
} 


具体 的 失败 重 试 则 是 在 runMethod () 方法 中 实现 的 ， 通 过 try 


catch 的 形式 ， 如 果 捕 获 到 测试 用 例 执 行 过 程 中 的 异 营 ， 例 如 用 例 断 言 


失败 ， 


决定 


现 


则 判断 runCount 是 否 小 于 tolerance 的 值 以 及 用 isRepetitive 参 数 来 
是 否 进 行 重 跑 。 


代码 清单 9-8 InstrumentationTestCase 中 的 runMethod () 源码 实 


private void runMethod(Method runMethod, int tolerance, boolean isRepetitive) 
throws Throwable { 


Throwable exception = null; 
int runCount = 0; 
do { 
try { 
/ /调用 执行 该 方法 


runMethod.invoke(this, (Object[]) null); 
exception = null; 
} catch (InvocationTargetException e) { 
e.fillIinstackTrace(); 
exception = e.getTargetException(); 
} catch (IllegalAccessException e) { 
e.fillIinstackTrace(); 
exception = e; 
} finally { 
runCount++; 
// Report current iteration number, if test is repetitive 
if (isRepetitive) { 
Bundle iterations = new Bundle(); 
iterations.putIint("currentiterations", runCount); 
getInstrumentation().sendSstatus(2, iterations); 
} 
} 


} while ((runCount < tolerance) && (isRepetitive || exception != null)); 
if (exception != null) { 

throw exception; 
} 


了 解 了 runTest 模 式 后 ， 就 可 以 目 定义 地 实现 更 接近 业务 的 失败 重 
试 及 截图 模式 。 可 以 编写 继承 和 目 InstrumentationTestCase 的 抽象 类 ， 履 
写 runTest () 方法 ， 其 中 可 以 对 捕获 到 的 异常 做 分 类 处理 、 进 行 序列 
化 截图 和 等， 大致 实现 思路 如 代码 清单 9-9 所 示 。 


代码 清单 9-9 ”继承 自 InstrumentationTestCase 窗 写 runTest () 方法 


QOverride 

protected void runTest() throws Throwable { 
String testMethodName = getName(); 
String currentTestClass = getClass().getName(); 
LogUtils.1logD(TAG, "currentTestClass:" + currentTestClass); 
boolean isScreenShot = true; 
boolean isScreenShotwhenPass = false,; 
boolean isUseFullSsScreen = true; 


long StartTime = 0; 

long endTime = 0; 

currentActivity = getActivity().getCclass().getSsimpleName(); 
LogUtils.1logD(TAG, "currentActivity:" + currentActivity); 

Holo holo = new Holo(getInstrumentation(), getActivity()); 
Method method = getClass().getMethod(getName(), (Class[]) null); 
/ /定义 重 试 次 数 


int retrytime = DEFAULT_RETRY_TIME; 
if (method.isAnnotationPresent(RetryTest.class)) { 
// 重 试 次 数 可 以 通过 注解 


@RetryTest(retrytime=1 ) 设 置 


retrytime = method.getAnnotation(RetryTest.class).retrytime( ); 
isScreenShot = method.getAnnotation(RetryTest.class).isScreenShot(); 
isUseFullScreen = 
method.getAnnotation(RetryTest.class).isUseFullSscreen(); 
} 
int runCount = 0; 
do { 
try { 
holo.goBackToActivity(currentActivity); 
if(runCount > 0){ 
holo,stopScreenshotSequence( ); 
/ /开启 序列 化 的 截图 功能 


holo.startscreenshotSequence(endTime, 5, testMethodName, 
currentTestClass); 
} 
startTime = SystemClock.uptimeMillis(); 
/ /执行 用 例 ， 即 执行 测试 类 中 的 


public 修 饰 的 


tesSst 开 头 的 方法 


Super .runTest() ， 

endTime = SystemClock.uptimeMillis() - startTime; 

LogUtils.1logD(TAG, "run test" + testMethodName + ",testcase pass with 
time cost:" + endTime); 

if(isScreenShotwhenpPass){ 
holo.takeSpoonSscreenShot(testMethodName, currentTestClass, testMethodName, DEFAULT_Q 
UALITY); 

} 


holo.finishOpenedActivitiesExcept(currentActivity); 
break; 
} catch (Throwable e) { 
/ /捕获 到 用 例 执行 过 程 中 有 异常 ( 


Throwab]e 包 括 断言 失败 时 的 抛 出 ) 时 ， 可 以 进行 各 类 处 理 


LogUtils.1logI(TAG, e);holo.takeSpoonSscreenShot("current_failed_ img", 
currentTestClass, testMethodName, DEFAULT_QUALITY ) ， 
// 对 


SecurityException 异 常 进行 特殊 处 理 


if(e.getMessage() !=null && 
e.getMessage().contains("SecurityException"))t{ 
/ /尝试 解除 屏幕 锁定 


SelfProcessUtils.wakeup(getInstrumentation().getTargetContext().getApplicationCon 


text()); 
SuperManager SuperManager = new SuperManager(); 
superManager .goBack( ) ， 
} 
/ /检查 
Wi -Fi 状态 


checkwifiStat(isUseFullscreen),; 
if(retrytime>1 && runCount<retrytime-1){ 
runCount++; 
endTime = SystemClock.uptimeMil]llis() - startTime; 
LogUtils.1logD(TAG, "run test" + testMethodName + ",testcase 
failed with time cost:" + endTime); 
continue; 
}else { 
if(isScreenShot){ 
LogUtils.1logD(TAG, "takeSscreenshot:"); 
holo.takeSpoonSscreenShot(testMethodName, currentTestClass, testMethodName, DEFAULT_Q 
UALITY); 


intentPerformance.putExtra("isStart", false); 
getActivity().sendBroadcast(intentPerformance); 
holo.finishOopenedActivitiesExcept(currentActivity); 
// 重 试 过 后 仍 失败 的 ， 需 要 最 后 抛 出 


throw e; 


} 


} while (runCount < retrytime); 


在 代码 清单 9-9 中 ， 使 用 了 自 定 义 的 takeSpoonScreenShot (String 
tag ~ String testClassName 、String testMethodName、int quality) 方法 ， 
结合 了 Robotium 中 序列 化 截图 方法 与 Spoon 中 截图 的 命名 规范 ， 用 于 
在 用 例 失败 后 ， 对 重 试 过 程 进行 抽样 截图 。 在 用 例 执行 失败 后 ， 也 可 
以 进行 网 络 状态 检查 ， 当 网 络 未 连接 时 可 目 动 进行 网 络 重 连 等 ， 以 减 
少 用 例 因 网 络 偶然 性 因素 导致 的 误 报 现象 。 使 用 覆 写 runTest 〈) 方法 


的 形式 ， 也 可 以 增加 更 多 目 定义 的 操作 ， 例 如 在 用 例 执行 前 开局 性 能 
监控 、 代 码 窗 六 收集 等 ， 以 最 大 化 地 文 撑 业 务 需 要 。 


ee 


如 9.3.1 节 所 介绍 的 ，Spoon 会 生成 类 似 单元 测试 形式 的 XML 报 告 文 
件 ， 因 此 其 他 测试 平台 可 以 通过 解析 junit-reports 目 录 下 的 XML 报 告 获 
取 用 例 执行 的 详细 数据 ， 对 每 次 的 测试 进行 入 库存 储 ， 积 累 日 常 的 测 
试 数据 ， 生 成 历史 记录 的 测试 报告 页 面 ， 如 图 9-10 所 示 。 


士 作 
人 


Spoon 生 成 汇 忌 报告 


岛 应 用 宝 自动 化 用 例 数 据 (默认 量 示 主干 分 支 ) 


Show| 10 
IDs svn 版 
231 r116378 


230 r116378 


229 r116232 


228 r115865 


227 r115865 


数 宇 版 本 


“=¥ 


6.3.0.5315 


6.3.0.5315 


6.3.0.5275 


6.3.0.5136 


6.3.0.5136 


通过 用 例 


122 


138 


138 


139 


139 


总 用 例 
数 


124 


139 


139 


139 


139 


创建 时 间 


2016-02-05 
04:33:25.0 


2016-02-04 
04:40:18.0 


2016-02-03 
04:43:32.0 


2016-02-02 
04:36:27.0 


2016-02-01 
04:40:56.0 


积 素 日 币 的 测试 数据 


叭 满 


9.4 Robotium 跨 应 用 


使 用 Robotium 编 写 的 自动 化 测试 用 例 是 基于 Instrumentation 的 ， 在 
执行 过 程 中 将 测试 代码 注入 被 测 应 用 程序 所 在 的 进程 ， 即 测试 代码 与 
被 测 应 用 运行 于 同一 进程 ， 而 出 于 安全 方面 的 考虑 ，Android 中 的 普通 
应 用 进程 不 允许 发 送 类 似 KeyEvent 的 事件 。 因 此 ， 当 测试 过 程 中 应 用 
跳 转 至 第 三 方 应 用 或 系统 界面 ， 此 时 仍 调用 dickOnView (View 
view) 方法 时 ， 则 会 报 SecurityException 的 异常 。 基 于 Instrumentation 
的 测试 框架 带 来 了 诸多 优势 的 同时 ， 却 也 有 天 生 无 法 跨 应 用 这 一 和 劣 
势 ， 而 在 实际 项 目 中 还 存在 许多 需要 跨 应 用 的 测试 场景 ， 本 广 介 绍 结 
合 UIAutomator 及 UIAutomation 实 现 跨 应 用 的 方法 ， 以 便 基于 Robotium 
的 自动 化 测试 适用 于 更 多 测试 场景 。 


9.4.1 UIAutomator Dump 方 式 跨 应 用 


我 们 知道 UIAutomator 是 文 持 跨 应 用 的 ， 当 手机 拥有 ROOT 权 限 
时 ， 可 以 使 用 adb 执 行 UIAutomator Dump 方 法 时 将 当前 界面 的 UI Dump 
至 指定 文件 ， 代 人 码 如 下 : 


F:\>adb shell uiautomator dump 
UI hierchary dumped to: /storage/emulated/legacy/window_ dump.xml 


打开 相应 的 xml 文 件 如 图 9-11 所 示 ， 可 以 看 到 dump 出 来 的 文件 包括 
UJI 结 构 中 的 常用 信息 ， 且 bounds 属 性 售 该 控件 在 屏幕 中 的 坐标 信息 。 


<?xml version="1.0" encoding="UTF-8" standalone= "true"?> 
<hierarchy rotation="0"> 

<node bounds="[0,0][1080,1920]" selected="false" password="false" long-clickable="false" scrollable="fa 
package="com.android.contacts" class="android.widget.FrameLayout" resource-id="" text="" index="0" 
<node bounds="[0,0J][1080,1920]" selected="false" password="false" long-clickable="false" scrollable 
package="com.android.contacts" class="android.widget.LinearLayout" resource-id="android:id/win 
- <node bounds="[0,0][1080,1920]" selected="false" password="false" long-clickable="false" scrolla 
package="com.android.contacts" class="android.view.View" resource-id="android:id/decor_con 
<node bounds="[0,75][1080,267]" selected="false" password="false" long-clickable="false" sc 
package="com.android.contacts" class="android.widget.FrameLayout" resource-id="android 
- <node bounds="[0,75][1080,267]" selected="false" password="false" long-clickable="false 
package="com.android.contacts" class="android.widget.HorizontalScrollView" resource-| 
<node bounds="[0,75][1080,267]" selected="false" password="false" long-clickable="f. 
package="com.android.contacts” class="android.widget.LinearLayout" resource-id="" 
<node bounds="[0,75][270,267]" selected= "true" password="false" long-clickable=' 


图 9-11 UIAutomator Dump 出 的 xml 文 件 


在 第 3 章 中 介绍 过 Robotium 的 动作 原理 ， 其 中 的 核心 实现 包括 控件 
获取 与 发 送 模拟 操作 ， 而 从 图 9-11 的 dump 信 息 中 可 以 看 到 ， 通 过 adb 
shell uiautomator dump 的 方式 可 以 获取 UI 元 素 在 屏幕 中 的 坐标 ， 而 使 用 
adb shell 的 方式 是 可 以 发 送 模拟 操作 的 ， 因 此 完全 可 以 通过 uiautomator 


dump 获 取 控件 再 结合 adb shell 发 送 模拟 操作 来 实现 一 个 基本 的 自动 化 测 
试 框架 。 
基于 此 思路 的 方案 在 开源 界 已 有 简单 的 实现 ， 项 目地 址 为 ， 


https://github.com/gb112211/Adb-For-Robotium 。 


此 方案 可 以 实现 跨 应 用 ， 但 缺点 也 较为 明显 ， 由 于 需要 不 断 地 
dump 界 面 并 解析 ， 在 执行 速度 及 稳定 性 上 无 法 得 到 保证 ， 且 还 需要 手 
机 拥有 ROOT 权 限 。 


9.4.2 ”UIAutomator 结 合 Instrumentation 模 式 


2015 年 3 月 ，Android Developers 团 队 宣布 了 UIAutomator 2.0 版 本 的 
发 布 ， 这 个 版 本 最 重要 的 特征 就 是 UIAutomator 终 于 可 以 基于 
Instrumentation 了， 使 用 mnstrumentation test runner 即 可 运行 
UIAutomator。 反 过 来 ， 即 在 基于 Instrumentation 的 Test 中 也 能 使 用 
UIAutomator。 因 此 测试 工程 可 同时 使 用 Robotium 和 UIAutomator 进 行 更 
丰 宦 的 测试 。 


新 版 的 UIAutomator 随 Android Support Repository 发 布 ， 可 通过 SDK 
Manager 下 载 ， 以 2.1.0 版 本 为 例 ， 位 于 如 下 代码 示例 所 示 的 路 径 中 : 


%ANDROID HOME%\extras\android\m2repository\com\android\support\test\ 
uiautomator\uiautomator-v1i8\2.1.0 


新 的 测试 支持 库 基 本 都 是 基于 Android Studio 库 的 ， 文 件 以 aar 结 尾 
而 非 以 jar 结 尾 ， 本 小 节 为 方便 在 Eclipse 中 介绍 ， 需 要 将 aar 转 化 成 jar。 


如 图 9-12 所 示 ， 使 用 压缩 工具 打开 uiautomator-v18-2.1.0.aar 文 件 ， 
里 面 的 classes.jar 文 件 就 是 可 用 于 Eclipse 的 UIAutomator jar 包 。 提 取出 该 
classes.jar 文 件 并 重 命名 为 方便 记忆 的 jar 包 文件 ， 导 入 到 使 用 了 
Robotium 的 测试 工程 即 可 。 


E:\Android\sdk\extras\android\m2repository\com\android\support\test\viautomator\yiautomator-v18\2.1.0\uiautomator-v18-2.1.0,.aal\ 
文件 (月 ” 编 铝 (E) ”查看 (V) ”书签 (A) “工具 (和 ”帮助 (H) 


中 vy 趾 加 区 蔗 


添加 提取 测试 复制 移动 删除 信息 


L | E\Android\sdk\extras\android\m2repository\com\android\support\test\viautomator\uiautomator-v18\2.1.0\uiautomator-v18-2.1.0.a 


大 小 压缩 后 大 小 ”修改 时 间 
871 522 2015-04-15 17:51 
2015-04-15 17:51 
2015-04-15 17:51 
0 2015-04-15 17:51 
LAndroidManifest.xml 871 2015-04-15 17:51 
| classesjar 123 821 2015-04-15 17:51 


图 9-12 ”解压 aar 文 件 


如 图 9-13 所 示 ， 应 用 至 在 通知 栏 中 开局 了 快捷 工具 栏 ， 测 试 此 功能 
时 需要 开局 通知 栏 ， 并 点 击 工 具 栏 中 的 按钮 ， 这 样 的 操作 仅 通过 
Robotium 框 染 是 无 法 完成 的 ， 此 时 就 可 以 结合 UIAutomator 来 实现 。 


UIAutomator 发 布 2.0 版 本 后 ， 可 以 通过 传 入 Instrumentation 对 象 获 
得 UIDevice 对 象 。 通 过 UIDevice 对 象 可 以 完成 点 击 Home 键 、 打 开通 知 
栏 ， 并 可 以 通过 UIDevice 的 findObject 方 法 根据 文本 、 资 源 ID 等 查找 控 
件 ， 然 后 通过 UIObject 对 和 象 完成 扣 击 操作 。 结 合 UIAutomator 的 测试 示 
例如 代码 清单 9-10 所 示 。 


20:24 ?32 | 本 A 


(1450,-4) 


4 Re [5 4 (0) RelativeLayout [24,546][214.738] ~ 
翼 了 4 (0) RelativeLayout [74.567][164.657] 
位 置 手 申 图 扳 动 族 转 (0) ImageView [74,567][164,657] 国 
只 (1) TextView:75 [74,567][158,657] 
天 [0D TextView:???? [53,672]{185,716] 


4 (1) RelativeLayout [214,546][405,738] 
4 (0) RelativeLayout [264,567][354,.657] 
(0) ImageView [264,567][354,657] 
(1) TextView:?27? [243.672][375.716] 


mn ls Ea aA AN 


«| nm 上 
Node Detail 
index 和 全 
text ?777 | 
已 连接 为 媒体 设备 resource-id comtencent.android.qqdownloader:id/entry text 1 
轻 敲 获取 其 他 USB 选项 class android.widget.TexiView 
package com.android.systemui 
content-desc 
checkable false 
checked false 
clickable false 
enabled true 
focusable false y 
可 二 J 有 = 


图 9-13 ”应 用 至 快捷 工具 栏 


代码 清单 9-10 结合 UIAutomator 的 测试 示例 


package com.tencent.assistant.qa.checklist.nuclear; 
import android,.support.test.uiautomator .UiDevice,; 
import android,.support.test.uiautomator .UiObjectNotFoundException; 
import android.support.test.uiautomator .UiSelector,; 
import android.test.ActivityInstrumentationTestCase2，; 
import com.robotium.solo.Solo; 
import com.tencent.assistant.qa.constant.YYBConstant,; 
import com.tencent.assistant.qa.util,.LogUtils,; 
yA 
* 测试 快捷 工具 栏 


,示例 


* @author hangtechen 

A 

public class QuickToolBarTestDemon extends ActivityInstrumentationTestCase2{ 
private static final String LAUNCHER_ACTIVITY_FULL_CLASSNAME = 

YYBConstant .LAUNCHER_ACTIVITY,; 
private static Class launcherActivityClass,; 
statict{ 
try 
{ 
launcherActivityClass=Class.forName(LAUNCHER_ACTIVITY_FULL_CLASSNAME ) ， 
} catch (ClassNotFoundException e){ 


throw new RuntimeException(e); 

} 
} 
private static final String TAG=QuickToolBarTestDemon.class.getSimpleName(); 
private Solo solo,; 


public QuickToolBarTestDemon() { 
super(launcherActivityClass); 


} 
@Override 
public void setUp(){ 
try { 
super.setUp(); 
} catch (Exception e) { 
LogUtils.1logE(TAG, e); 
} 
solo = new Solo(getInstrumentation(), getActivity()); 
} 
@Override 


public void tearDown(){ 
hideNotification(); 
solo.finishOpenedActivities(); 
try { 
solo.finalize( ); 
} catch (Throwable e1) { 
LogUtils.1logE(TAG, el1); 
} 


solo = null; 
try { 
super .tearDown( ); 
} catch (Exception e) { 
LogUtils.1logE(TAG, e); 
} 


} 
/A 
* 测试 快捷 工具 栏 中 的 手机 加 速 功能 


</br> 


* 工 ,开启 快捷 工具 栏 


</br> 


* 2 ,进入 快捷 工具 栏 ， 点 击 手机 加 速 按 钮 ， 等 待 加 速 完成 


* 3 ,断言 是 否 出 现 加 载 完成 的 动画 


public void test76417919 _ QuickToolBar_ClickAccelerate( ){ 
hideNotification(); 
openQuickToolBar();  // 进 入 设置 页 开启 快捷 工具 栏 ， 此 处 为 伪 代 码 


checkQuickToolBarByText(" 手 机 加 速 


"); 


// 完 成 点 击 操作 后 ， 此 处 增加 操作 后 的 期 望 断 言 等 


} 

private boolean checkQuickToolBarByText(String item)f{ 
boolean isFind = false,; 
/ /通过 


InstrumentatIon 获 取 


UiDevice 单 例 


UiDevice uiDevice = UiDevice.getIinstance(getInstrumentation()); 
uiDevice.pressHome( ); 
solo.sleep(1000); 
uiDevice.openNotification(); 
solo.sleep(1000); 
try { 
uiDevice.findobject(new UiSelector().text(item)).click(); 
isFind = true,; 
} catch (UiObjectNotFoundException e) { 
LogUtils.1logE(TAG, e); 
} 


return isFind; 


} 
private void hideNotification(){ 
UiDevice uiDevice = UiDevice.getIinstance(getInstrumentation()); 
if(uiDevice.getCurrentPackageName().equals("com.android.systemui")){ 
uiDevice.pressBack(); 
} 


代码 清单 9-10 中 使 用 的 findObject 方 法 得 到 的 是 UIObject 对 象 ， 此 外 
也 可 以 通过 By 的 方式 获取 UIAutomator 中 的 UIObject2 对 象 ， 例 如 : 


uiDevice,.findobject(By.res("com.tencent.android.qqdownloader", 
"entry_text_1")).click(); 


UIAutomator2.0 还 有 许多 更 丰富 、 更 强大 的 功能 ， 这 里 束 不 再 一 一 
介绍 了 。 总 之 ， 通 过 与 Instrumentation 结 合 可 以 方便 地 在 测试 工程 中 完 
成 跨 应 用 的 操作 ， 进 行 更 丰富 的 测试 。 


9.5 “代码 履 盖 率 


9.5.1 禾苗 率 定 义 


作为 一 个 测试 人 员 ， 保 证 产品 的 软件 质量 是 其 工作 的 首要 目标 。 
为 了 这 个 目标 ,测试 人 员 常 第 会 通过 很 多 手段 或 工具 来 加 以 保证 ， 禾 
兰 率 吏 是 其 中 比较 重要 的 一 个 。 


我 们 通常 会 将 测试 覆 吉 率 分 为 两 个 部 分 ， 即 “需求 履 次 率 ?” 和 “代码 


履 盖 率 "。 


需求 黎 兰 率 : 指 测 试 人 员 对 需求 的 了 解 程度 ， 根 据 需 求 的 可 测试 
性 拆 分 成 各 个 子 需求 点 ， 来 编写 相应 的 测 斌 用例， 最 终 建 立 一 个 需求 
和 用 例 的 映射 关系 ， 以 用 例 的 测试 结果 来 验证 需求 的 实现 ， 可 以 理解 
为 黑金 禾 蓄 。 


代码 履 瘟 率 : 为 了 更 加 全 面 地 覆盖 ， 我 们 可 能 还 需要 理解 被 测 程 
序 的 逻辑 ， 需 要 考虑 到 每 个 画 数 的 输入 与 输出 、 逻 辑 分 文 代码 的 执行 
情况 ， 这 个 时 候 我 们 的 测试 执行 情况 殉 以 代码 履 兰 率 来 衡量 ， 可 以 理 
解 为 日 盒 复 闸 。 


以 上 两 者 完全 可 以 相辅相成 ， 用 代码 覆盖 结果 反 向 地 检验 需求 覆 
盖 (用 例 ) 的 测试 是 否 充 分 完整 。 


那么 如 何 做 覆 雷 率 测试 呢 ? 本 太 会 完 简 单 介绍 一 下 比较 主流 的 几 
种 覆盖 率 工 具 ， 然 后 选取 JaCoCo 〈 适 合 Java 的 程序 ) 进行 详细 介绍 ， 
其 他 工具 思路 大 体 是 相同 的 ， 读 者 可 以 举一反三 ， 根 据 目 己 项 目的 特 
点 选取 合适 的 履 兰 率 工 具 。 


率 工 具 
流行 的 
官 


9.5.2” 履 盖 


1.Javascript 测 试 履 盖 率 工具 
JSCoverage: 一 个 用 于 度量 Javascript 程 序 的 代码 覆盖 率 的 工具 ， 


JSCoverage 支 持 IE6、IE7、Firefox2、Firefox3、Opera、Safari 等 
文 持 Windows 平 台 和 Linux 平 台 ，JSCoverage 是 开源 软件 ， 


中 入 晶 已 
0 人 ， 


训 
方 网 站 为 : http:/siliconforks.coryjscoverage/。 


2.Java 测 斌 覆盖 率 工 具 
Emma: 离线 插 桩 模式 ， 即 先 编译 出 class 文 件 ， 然 后 插 桩 ， 打 包 


不 文 持 分 文 禾 兰 率 ， 其 使 用 手册 地 址 为 : 


http://emma.sourceforge.net/reference_single/reference.htm] 。 


JaCoCo， 特色 是 引入 agent， 支 持 在 线 搬 桩 模式 ， 即 在 class 加 载 的 
时 候 即 时 搬 桩 ， 同 时 也 支持 离线 播 桩 ， 具 有 丰富 的 dump 机 制 ， 支 持 分 
-是 


运行 
http://eclemma.org/JaCoCo/index.html 。 支持 gradle 方 式 ， 我 们 在 


支 宪 盖 率 ， 运 行 速度 比较 快 。 其 使 用 地 址 为 : 
Android 履 盖 率 方面 选用 的 工具 为 JaCoCo， 优 势 主 要 集中 在 两 点 : 
JaCoCo 社 区 比较 活路 ， 它 是 原 Emma 团 队 新 推出 的 履 盖 率 工具 ，Emma 


项 目 已 经 很 久 没 有 更 新 了 ; 二 是 JaCoCo 比 Emma 多 了 分 支 窗 盖 。 


Coverlipse: 一 个 Eclipse 的 Code coverage 搬 件 。 


Cobertura: 一 种 开源 工具 ， 它 通过 检测 基本 的 代码 ， 并 观察 在 测 
试 包 运 行 时 执行 了 哪些 代码 和 没有 执行 哪些 代码 ， 来 测量 测试 柳 兰 
率 。 除 了 找 出 未 测试 到 的 代码 并 发 现 pug 外 ，Cobertura 还 可 以 通过 标记 
无 用 的 、 执 行 不 到 的 代码 来 优化 代码 ， 还 可 以 提供 API 实 际 操作 的 内 


部 信息 。 


3..NETI 测 试 履 盖 率 工具 


Clover.NET: Visual Studio 的 代码 覆盖 率 统 计 工 具 ， 其 官方 网 站 


为 : http://www.cenqua.com/clover.net/ 。 
NCover 官 方 网 站 为 : http:/ncoverorg/。 


PartCover: 与 NCover 非 常 相似 ，PartCover 是 针对 .NET 的 一 个 开源 
代码 履 盖 工具 。 它 包括 了 一 个 控制 台 应 用 程序 ~、GUI 窗 新 浏览 器 ， 以 
及 用 在 CC.NET 中 的 xsl 转 换 。 


4.C/C++ 测 试 履 盖 率 工具 


Bullseye Coverage: Bullseye 公 司 提 供 的 一 款 C/C++ 人 代码 履 盖 率 测 
斌 工具， 除了 文 持 各 种 UNIX 下 的 编译 絮 之 外 ， 在 Windows 下 还 文 持 
VC、Borland C++、Gnu C++、Inter C++。 提 供 的 代码 覆盖 率 是 分 文 覆 


盖 率 而 不 是 一 般 的 代码 履 盖 率 ， 个 人 认为 分 支 履 盖 率 比 代 码 窗 盖 率 更 
好 。Bullseye Coverage 可 以 从 http://www.bullseye.com/ 上 获取 。 


5.Ruby 测 试 履 六 率 工具 


rcov: 一 个 用 于 诊断 Ruby 代 码 履 雷 率 的 工具 ， 它 最 主要 的 用 还 整 
征 确 定单 元 测试 是 否 黎 次 到 所 有 代码 ，rcov 使 用 一 个 经 过 优化 的 C 运 
行 ， 因 此 性 能 相当 惊人 ， 同 时 它 还 提供 多 种 格式 的 输出 。 


6. 其 他 


AutomatedQA 公 司 的 AQtime。AqaQtime 运 行 在 Windows 平 台 上 ， 它 
文 持 .NET 应 用 和 非 .NET 应 用 ， 但 不 文 持 Java 必 用 。AQtime 除 了 包含 代 
码 履 盖 率 监测 以 外 ， 还 包括 性 能 监视 等 功能 。 


DevPartner Studio 的 Web script Coverage 工 具 。 该 工具 主要 是 收集 
Web 客 户 端 script 脚 本 办 善 率 的 。 


9.5.3 JaCoco 介 绍 与 实践 


1.JaCoCo 简 介 


JaCoCo 是 一 个 开源 的 覆盖 率 工具 (官网 地 址 : 
http://www.eclemma.org/JaCoCo/ ) ， 它 针对 的 开发 语言 是 Java， 其 使 用 
方法 很 灵活 ， 可 以 嵌入 Ant、Maven 中 ， 可 以 作为 Eclipse 插件 ， 还 可 以 
使 用 其 JavaAgent 技 术 监控 Java 程 序 等 。 很 多 第 三 方 的 工具 提供 了 对 


JaCoCo 的 集成 ， 如 sonar、Jenkins 等 。 


JaCoCo 包 含 了 多 种 尺度 的 覆盖 率 计数 右 ， 包 含 指令 覆盖 
(Instructions，COcoverage) 、 分 支 窗 盖 (Branches,，Clcoverage) 、 
圈 复 杂 度 (CyclomaticComplexity) 、 行 覆盖 (Lines) 、 方 法 覆盖 
(non-abstract methods) 、 类 履 盖 (classes) 等 (详细 内 容 后 面 会 有 介 


人 


我 们 可 以 爷 看 看 其 上 黎 兰 率 的 结果 展现 ， 如 图 9-14 所 示 。 


1T4. public void freshYiew(int type) { 
175, int size = 0 
1T6，| 今 if (this. inSanoTaghpp { 

size = A size (): 
} else { 

size = apps. size(); 
J 
forlint i=0; i¢< size; i+H) { 


if (appLayouts[i] |= mmll) { 
appLayouts[i].setYisibility (View, YISIBLE) 


SH 


Re ecommendAppIrfo detail = apps. get ( 
186. appImages[i]. pdateImageView'( re in R. drawable.plc_defaule，TXImageVYiewIType. 了 TVWOFK_DILACE_ICON : 
187. try { 
188 appTexts[i]. setText (Html. fromHtml (detail. applame)) 
} catch (WullPointerFxception e) { 
e.pIintStackTracef) : 


191. } 
192. |@ if(ITextUtils. isEmpty (sethppDescription(i))) { 
appReasons [i]. setText (Html. fromHtml (get AppDescription(i))); 
appReasons [i]. setVisibility (View,. YISIBLE); 
}elsel{ 


appReasons [i]. setYisibility (View, GONE) ; 


图 9-14 ”覆盖 率 报告 结果 部 分 截图 


标 绿色 的 为 行 履 盖 充分 《如 481~488 行 ) ， 标 红色 的 为 未 覆盖 的 行 
4477 行 、489 行 、490 行 ) ， 标 黄色 莪 形 的 为 分 支部 分 覆盖 (476 行 、 
482 行 ) ， 标 绿色 菱形 的 为 分 支 完 全 和 窗 盖 《481 行 ) 。 通 过 这 个 报告 结 
果 束 可 以 知道 代码 真实 的 执行 情况 ， 便 于 我 们 分 析 评 估 结 


辐 注 言 ”截图 是 带 有 颜色 的 ， 如 果 图 打印 成 黑白 色 ， 请 读者 参 
孝 括 号 里 的 行 号 ， 这 里 主要 是 摘 述 一 个 后 ，JaCoCo 对 徐 六 率 结 琳 会 有 
不 同样 式 的 展现 。 


2.JaCoCo 知 识 点 


JaCoCo 使 用 一 系列 的 不 同 的 计数 器 来 做 覆盖 率 的 度量 计算 ， 所 有 
这 些 计数 器 都 是 从 Java 的 class 文 件 中 获取 信息 ， 这 些 class 文 件 里 面 可 以 
包含 调试 的 信息 。 即 使 在 没有 源码 的 情况 下 ， 这 种 方法 也 可 以 实时 有 


效 地 对 应 用 程序 进行 度量 和 分 析 ， 但 看 不 到 具体 源码 的 覆盖 率 执 行情 
况 。 如 来 做 详细 的 覆盖 率 分 析 ， 必 须 指 定 源 码 ， 这 样 可 视 化 到 每 一 行 
代码 的 粒度 (图 9-14) 。 前 提 是 这 些 class 文 件 必须 使 用 调试 信息 来 编 
译 ， 这 样 才 可 以 计算 行 的 覆盖 率 和 提供 出 源码 的 高 亮 。 


JaCoCo 主 要 有 以 下 几 个 纬度 数据 : 


JaCoCo 最 小 的 计数 单元 是 单个 Java 二 进 制 代码 指令 。 指 令 覆 盖 率 
提供 了 代码 是 否 被 执行 的 信息 。 这 个 度量 完全 独立 于 源码 格式 ， 即 使 
class 文 件 里 面 没 有 调试 信息 也 总 是 可 用 的 。 


JaCoCo 也 计算 分 文 的 覆盖 率 ， 包 括 所 有 的 让 和 switch 语 句 。 这 个 度 
量 计算 一 个 方法 里 面 的 总 分 支 数 ， 确 定 执行 和 不 执行 的 分 支 数量 。 
支 覆 盖 率 总 是 可 用 的 ， 即 使 class 文 件 里 面 没有 调试 信息 。 注 意 ， 异 
处 理 是 不 在 分 支 度量 里 面 统计 的 。 如 果 class 文 件 使 用 调试 信息 编译 
话 ， 产 生 的 覆盖 率 可 以 映射 到 源码 行 并 且 高 亮 提示 : 


~、 


分 
名 


的 


:没有 禾 盖 :在 这 一 行 中 没有 分 支 被 执行 (红色 方块 ) ; 


-部 分 覆盖 :这 一 行 的 分 支 中 只 有 一 部 分 被 执行 (黄色 方块 ); 


-完全 覆盖 : 这 一 行 的 所 有 分 文 都 被 执行 〈 绿 色 方块 ) 。 


浊 


3) 圈 复 杂 


JaCoCo 同 样 可 以 为 每 一 个 非 抽 象 方法 计算 复杂 度 ， 最 终 计算 出 
类 、 包 和 组 的 复杂 度 。 由 McCabe1996 可 知 圈 复 杂 度 的 定义 是 ， 在 ( 线 
性 ) 组 合 中 ， 计 算 在 一 个 方法 里 面 所 有 可 能 路 径 的 最 小 数目 。 所 以 复 
杂 度 可 以 作为 度量 单元 测试 是 否 完全 覆盖 所 有 场景 的 一 个 依据 ， 复 杂 
度 即使 是 在 没有 调试 信息 的 情况 下 也 可 以 计算 。 


圈 复 杂 度 V (G) 的 正式 定义 是 基于 方法 的 控制 流 图 的 有 向 图 表示 


V (G) =E-N+2 


E 是 边界 的 数量 ，N 是 市 点 的 数量 。JaCoCo 基 于 下 面 的 方程 来 计算 
复杂 度 ，B 是 分 文 的 数量 ，D 有 是 决策 点 的 数量 : 


V (G) =B-D+1 


基于 每 个 分 支 的 被 覆盖 情况 ，JaCoCo 也 为 每 个 方法 计算 覆盖 和 缺 
失 的 复杂 度 。 缺 失 的 复杂 度 同 样 表示 测试 案例 没有 完全 覆盖 到 这 个 模 
块 。 注 意 JaCoCo 不 将 异常 处 理 作 为 分 文 ，try/catch 块 也 同样 不 增加 复杂 
度 o 


4 入 

所 有 的 class 文 件 使 用 debug 信 息 编译 之 后 ， 就 可 以 计算 行 的 覆盖 率 
信息 。 一 行 源 代码 是 否 被 执行 ， 要 看 这 一 行 中 是 否 至 少 有 一 个 指令 被 
执行 。 


由 于 实际 上 一 行 代码 一 般 被 编译 成 多 个 二 进 制 代码 指令 ， 这 样 源 


码 在 高 亮 显示 时 ， 会 显示 成 三 种 不 同 的 状态 : 


-没有 履 盖 : 这 一 行 中 没有 指令 被 执行 (红色 背景 ) ; 


-部 分 覆盖 : 这 一 行 中 只 有 一 部 分 指令 被 执行 《黄色 背景 ) ; 


-完全 覆盖 : 这 一 行 中 所 有 指令 都 被 执行 绿色 背景 ) 


5) 方法 覆盖 


每 一 个 非 抽 象 方法 至 少 包含 一 个 指令 ， 一 个 方法 是 否 执 行 取决 于 
方法 中 是 否 有 至少 一 个 指令 被 执行 。 在 JaCoCo 中 ， 构 造 器 和 静态 初始 
化 同样 会 像 方 法 一 样 统计 ， 其 中 一 些 方法 可 能 没有 可 以 直接 对 应 的 源 
码 ， 比 如 默认 构造 器 或 常量 的 初始 化 命令 。 


6) 类 禾 盖 


一 个 方法 是 否 执行 取决 于 类 中 是 否 至 少 有 一 个 方法 被 执行 ， 注 意 
JaCoCo 认 为 构造 器 和 静态 初始 化 都 是 方法 ，Java 的 接口 一 般 包含 静态 


初始 化 ， 所 以 接口 也 同样 被 认为 是 可 执行 的 类 。 
7) 包 禾 盖 


包 履 盖 描 述 一 个 package 的 和 覆盖 程度 ， 在 XML 报告 中 有 数据 体现 ， 
HTML 报 告 中 只 能 去 综合 评 佑 。 


3.JaCoCo 实 践 


本 小 JaCoCo 实 践 包 括 代 码 插 桩 与 编译 打包 、 执 行 测试 并 收集 履 
次 率 结 末 、 生 成 履 兰 率 报告 、 分 析 履 兰 率 结 采 等 主要 步 又 。 


步骤 1: 代码 插 桩 与 编译 打包 。 


以 Android 项 目 使 用 Ant 进 行 编译 为 例 ， 可 以 修改 build， 将 JaCoCo 
的 部 分 添加 进去 ， 这 样 打 成 的 包 即 为 覆盖 率 包 。 
(1) 文件 开头 的 命名 空间 加 入 以 下 代码 。 


xmlns:JaCoCco="antlib:org.JaCoCo.ant" 


(2) 引入 Jacoco 的 jar 和 相关 定义 。 


<taskdef uri="antlib:org.JaCoCo.ant" 
resource="org/JaCoCo/ant/antlib.xml"> 
<classpath path="${basedir}/libs/JaCoCoant.jar" /> 


(3) 重新 定义 class 文 件 生 成 路 径 。 


<property name="classes_instr" value="${temp}/classes_ instr" /> 


(4) 修改 编译 季 点 ， 进 入 class 文 件 ， 注 入 以 下 代码 。 


<JaCoCo:instrument destdir="${classes_instr}"> 
<fileset dir="${classes}" includes="**/*,.class" /> 
</JaCoCo:instrument> 


(5) 修改 打包 ， 主 要 是 指定 JaCoCo 编 译 后 的 类 路 径 。 


<jar basedir="${classes_ instr}" destfile="temp.jar" /> 


(6) 修改 混淆 ， 增 加 混淆 所 需要 的 代码 如 下 : 


<arg value="-libraryjars ${1lib}/JaCoCoant.jar" /> 
<arg value="-libraryjars ${1lib}/JaCoCoagent.jar" /> 


(7) 其 他 。 如 果 项 目 有 dlean、remove 等 操作 ， 需 要 根据 上 面 的 修 
改 做 相应 的 清理 工作 。 


(8) 执行 Ant， 编 译 生成 新 的 带 有 和 履 盖 率 的 测试 包 。 
若是 使 用 Gradle 进 行 编译 ， 则 过 程 包括 以 下 几 方 面 。 
.在 项 目的 build.gradle 引 入 插件 。 


apply plLugin: 


"jacoco" 


注 明 使 用 的 版 本 号 ， 如 下 : 


Jacoco { 
version "0.7.4.201502262128" 
} 


.声明 一 个 gradle task 。 


task jacocoTestReport(type:JacocoReport, dependsOon:"connectedAndroidTest"){ 
group = "Reporting" 

description = "Generate Jacoco coverage reports after running tests." 
reportst 

xml.enabled = false 

html.enabled = true 

csv.enabled = false 


classDirectories = fileTree( 


dir : "$buildDir/intermediates/classes/debug", 
excludes : [ '**/*Test.class', '**/R.class', '**/R$*.class', '**/BuildConfig.*', 
'**/Manifest*.*' ] ) 


def coverageSourceDirs = ['src/main/java'] 

additionalSourceDirs = files(coverageSourceDirs) 

sourceDirectories = files(coverageSourceDirs) 

additionalClassDirs = files(coverageSourceDirs) 

executionData = files("$buildDir/outputs/code-coverage/connected/coverage.ec") 


} 


.打开 testCoverageEnabled。 需 要 注意 的 是 ， 打 开 该 属性 的 话 ， 在 断 
点 调试 的 时 候 会 导致 方法 参数 值 丢 失 (看 不 到 ) ， 所 以 在 调试 的 时 候 
要 记得 把 它 关 掉 。 


buildTypes { 

debug{ 
testCoverageEnabled true 
} 

} 


完整 的 Gradle 配 置 如 代码 清单 9-11 所 示 。 


代码 清单 9-11 完整 的 Gradle 配 置 


apply plugin: 'com.android.1library'apply 
plugin: 'jacoco'android { 
compileSsdkVersion 22 

buildToolsVersion '22.0.1' 

defaultConfig { 

minSsdkVersion 8 

targetsdkVersion 22 

versionCode 1 

versionName "1.0" 


3 

buildTypes 

{ 

release { 

minifyEnabled true 

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 
} 

debug{ 

testCoverageEnabled true 


} 


lintOoptions { 

abortOnError false 

} 

packagingoptions { 

exclude 'META-INF/NOTICE' 

exclude 'META-INF/LICENSE' 

} 

jacoco{ 

version "0.7.4.201502262128" 

} 

} 

task jacocoTestReport( 

type:JacocoReport, dependsOn:"connectedAndroidTest"){ 
group = "Reporting" 

description = "Generate Jacoco coverage reports after running tests." 
reportst 

xml.enabled = false 

html.enabled = true 

csv.enabled = false 


} 

classDirectories = fileTree( 

dir : "$buildDir/intermediates/classes/debug", 

excludes : [ '**/*Test.class', '**/R.class', '**/R$*.class', '**/BuildConfig.*', 
'**/Manifest*.*' ] ) 


def coverageSourceDirs = ['src/main/java'] 

additionalSourceDirs = files(coverageSourceDirs) 

sourceDirectories = files(coverageSourceDirs) 

additionalClassDirs = files(coverageSourceDirs) 

executionData = files("$buildDir/outputs/code-coverage/connected/coverage.ec") 
} 

dependencies { 

compile fileTree(dir: 'libs', include: ['*.jar']) 

compile 'com.android.support:appcompat-v7:22.2.1" 


} 


步 又 2: 执行 测试 并 收集 黎 凑 率 结 有 末 。 


收集 履 兰 率 的 方式 主要 是 反射 调用 JaCcoCo API 的 dump 方 法 ， 以 文 
件 追 加 的 方式 在 手机 上 写 履 兰 率 结 末 ， 实 现 方法 如 代码 请 单 9-12 所 示 。 


代码 清单 9-12 ”反射 调用 JaCoCo API 的 dump 方 法 


private void dumpCoverageJacoco(boolean reset){ 
String absFilePath = sdCard + (sdCard.endswith(File.separator) ? "coverage": 
File.separator + "coverage") + File.separator + getName()+".ec",; 
File coverageFile = new File(absFilePath); 
try { 
Class classAgentOptions = 
Class.forName("org.jacoco.agent.rt.internal bod6a23.core.runtime.AgentOptions"),; 
//Get setDestfile method in AgentOptions class 
Method methodSetDestFile = 
classAgentOptions.getMethod("setDestfile",String.class); 
//Get FileOutput class 
Class classFileOutput = 
Class.forName("org.jacoco.agent.rt.internal _bOd6a23.output.FileOutput"); 
//Get field "File destFile" in FileOutput class 
Field fieldFile = classFileOutput.getDeclaredField("destFile"); 
fieldFile.setAccessible(true); 
//Get Agent singleton by getAgent method in RT class 
Class<?> RT = Class.forName("org.jacoco.agent.rt.RT"); 
Method methodGetAgent = RT.getMethod("getAgent"); 
Object objAgent = methodGetAgent.invoke(null); 
//Get Agent Class 
Class classAgent = 
Class.forName("org.jacoco.agent.rt.internal b0d6a23.Agent"); 
//Get field "AgentOptions options" and "FileOutput output" in Agent Class 
Field fieldoptions = classAgent.getDeclaredField("options"); 
Field fieldoutput = classAgent.getDeclaredField("output"); 
fieldOoptions.setAccessible(true); 
fieldOoutput.setAccessible(true); 
//Get options/output object referenced by Agent singleton 
Object objOptions = fieldoptions.get(objAgent); 
Object objOutput = fieldOutput.get(objAgent); 
//change destFile attribute in options object by setDestfile method 
methodSetDestFile.invoke(objOptions,absFilePpath); 
//change field "File destFile" in output object 
File destFile = new File(absFilePath).getAbsoluteFile(); 
fieldFile.set(objOutput, destrFile),; 
//dump 
Method methodDump = classAgent.getMethod("dump",boolean.class); 
methodDump.invoke(objAgent, reset ) ， 
} catch (Exception e) { 
e.printSstackTrace( ); 
} 


} 


步骤 3: 生成 履 兰 率 报告 。 


通过 编写 report 的 build 脚 本 来 生成 报告 结果 ，build 脚 本 如 代码 清单 
9-13 所 示 ， 配 置 好 后 ， 执 行 Ant 即 可 。 


代码 清单 9-13 ”生成 履 凋 率 报 告 的 Ant 脚 本 


xmlns:JaCoCco="antlib:org.JaCoCo.ant" 
<project xmlns:jacoco="antlib:org.jacoco.ant" name="Example Ant Build with JaCoCo 
offline Instrumentation" default="rebuild"> 
<property name="result.dir" location="."/> 
<property name="src.dir" location="./src"/> 
<property name="result.classes.dir" location="${result.dir}/classes"/> 
<property name="result.report.dir" location="${result.dir}/report"/> 
<property name="result.report.xml" location="${result.dir}/result_ xml"/> 
<property name="result.exec.file" 
location="${result.dir}/testApkMgr_ClickCleanBtn_ShouldCleanApks.ec"/> 
<!-- Step 1: Import JaCoCo Ant tasks --> 
<taskdef uri="antlib:org.jacoco.ant" resource="org/jacoco/ant/antlib.xml"> 
<classpath path="./libs/jacocoant.jar"/> 
</taskdef> 
<target name="report"> 
<jacoco:report> 
<executiondata> 
<file file="${result.exec.file}"/> 
</executiondata> 
<structure name="JaCoCo Ant Example"> 
<classfiles> 
<fileset dir="${result.classes.dir}"/> 
</classfiles> 
<sourcefiles encoding="UTF-8"> 
<fileset dir="${src.dir}" includes="**/*,java" /> 
</sourcefiles> 
</structure> 
<html destdir="${result.report.dir}"/> 
<csv destfile="${result.report.dir}/report.csv"/> 
<xml 
destfile="${result.report.xml}/testApkMgr_ClickCleanBtn_ ShouldCleanApks .xml"/> 
</jacoco:report> 
</target> 
<target name="rebuild" depends="report"/> 
</project> 


若是 以 Gradle 方 式 ， 则 打开 Terminal， 并 输入 命令 “gradlew 


jacocoTestReport” (task 名 字 ) 执行 。 


步 又 4: 分 析 履 兰 率 结 采 。 


网 上 关于 JaCoCo 履 盖 率 报告 的 分 析 有 不 少 的 文章 可 以 学 习 ， 这 里 
主要 阐明 几 个 观点 。 


根据 项 目的 不 同 ， 在 分 析 结 果 前 应 该 先 明确 以 下 几 点 : 
(1) 确定 改动 点 的 范围 ， 根 据 这 个 范围 才能 有 针对 性 地 做 分 析 。 


我 们 不 可 能 对 全 部 代码 的 覆盖 率 结果 都 分 析 一 遍 ， 有 针对 性 地 进 
了 分析 才能 分 析 到 点 上 ， 笔 者 总 结 了 两 点 分 析 的 过 程 ， 分 享 给 大 家 : 


pA 


第 一 ， 和 开发 确认 好 本 次 修改 点 或 新 增 点 的 代码 范围 ， 如 SYN 从 
版 本 11765 到 11899 。 


第 二 ， 针 对 上 面 的 代码 范围 来 确定 我 们 履 凋 率 结 采 的 分 析 艺 围 ， 
这 里 主要 考虑 两 点 ， 一 是 代码 本 号 的 修改 范围 ， 二 是 修改 的 代码 和 其 
他 未 修改 代码 的 耦合 关系 范围 。 将 这 部 分 代码 履 兰 率 结 采 拿 出 来 作为 
我 们 分 析 的 源头 。 


(2) 改动 点 是 否 影响 功能 逻辑 ， 如 果 不 影 响 可 以 忽略 。 


不 是 所 有 的 改动 点 都 一 定 要 履 凋 到 ， 在 分 析 的 过 程 中 要 抓 住 重 
点 ， 建 议 梳理 出 功能 的 优先 级 ， 由 高 到 低 去 分 析 ， 原 则 上 有 几 个 点 可 
以 忽略 :保护 代码 《比如 非 空 判断 等 ) 、 异 常 和 catch 部 分 。 


(3) 改动 点 和 其 他 功能 钙 否 存在 而 合 ， 如 果 存 在 ， 厦 合 的 部 分 也 
要 做 分 析 。 


点 狗 兰 全 了 ， 也 要 考虑 面 的 复 兰 ， 这 样 才能 真正 完全 地 上 履 兰 。 


我 们 主要 从 上 面 儿 点 来 分 析 履 盖 率 ， 查 漏 补 缺 ， 这 些 改动 点 大 部 
分 已 经 窗 盖 到 了 ， 基 本 认为 应 用 的 主要 功能 独 斑 完全 ， 当 然 也 不 是 绝 
对 的 。 在 测试 过 程 中 ， 结 合 FreeTest、 探 索性 测试 等 手段 也 是 一 种 不 错 
的 选择 ， 切 记 不 要 盲目 地 为 了 覆盖 率 而 敌 盖 ， 和 窗 盖 率 高 并 不 代表 真 的 
黎 兰 完全 了 。 很 多 人 觉得 分 析 过 程 是 比较 痛 百 的 ， 不 妨 把 这 个 过 程 当 
作 一 种 给 炼 ， 前 面 的 一 切 都 只 是 一 个 铺 芭 ， 最 关键 的 丈 在 于 分 析 阶 
段 ， 一 个 出 色 的 分 析 结 东 可 以 达到 事半功倍 的 效 末 。 


除了 Apache Ant 方 式 外 ， 也 可 以 采用 其 他 方式 ， 例 如 : 


命令 行 方式 ， 可 以 参见 


http://www.eclemma.org/JaCoCo/trunk/doc/agent.htm!l ; 


Apache Maven 方 式 : 可 以 参见 


http://www.eclemma.org/JaCoCo/trunk/doc/maven.html ; 


Eclipse EcdlDmma Plugin 方 式 : 可 以 参见 http:/www.eclemma.org/。 


4.JaCoCo 持 续集 成 


这 里 使 用 Jenkins 进 行 持续 集成 ， 步 骤 如 下 : 


(1) 在 Jenkins 上 安装 JaCoCo 的 插件 ， 安装 完成 之 后 在 job 的 配置 
项 中 吏 会 增加 JaCoCo 相 天 选项 ， 如 图 9-15 所 示 。 


Publish duplicate code analysis results 
Publish combined analysis results 
Aggregate downstream test results 
Archive the artifacts 

Buld other pi L 

Post build task 

Publish Cobertura oad Popust 
Publish JUNt test result re 

Publish Javadoc 

Publish Robot Framework test results 
Record fingerprints of files to track usage 
Build Pipeline Plugin -> Manually Execute Downstrea 
ClearCase UCM Makebaseline 

ClearCase UCM Makebaseline Composite 
Create ClearCase report 

E-mail Notification 

Editable Email Notification 


图 9-15 ”Jenkins 中 的 JaCoCo 插 件 


(2) 选择 Record JaCoCo coverage report 后 ， 在 第 一 个 输入 框 中 输 
入 覆盖 率 文件 (exec) ， 第 二 个 输入 框 中 输入 class 文 件 目录 ， 第 三 个 输 
入 框 中 输入 源 代 码 文 件 目 录 ， 如 图 9-16 所 示 。 


Record JaCoCo coverage report 


Path to exec files (e.g.: **/target/™™.exec, Path to class directories (e.g.: Path to source directories (e.g.: 
<**/j3acoco.exec) **/target/classDir, **/classes) **/mySourceFiles) 


**/*.exec |==/build/dasses |**/src/java 


图 9-16 Jenkins 中 Record JaCoCo coverage report 


(3) 配置 好 之 后 进行 构建 ， 构 建 完成 之 后 job 首页 就 会 出 现 覆 盖 率 
的 趋势 图 (图 9-17) ， 鼠 标点 击 趋势 图 则 可 以 看 到 有 覆 盖 率 详情 ， 包 括 具 
体 覆 盖 率 数据 和 源码 的 覆盖 率 情 况 等 。 


mlineCovered 
mlineMissed 


图 9-17 禾 盖 率 趋势 图 


9.5.4 BVT 测 试 与 覆盖 率 结合 


1.BVTI 测 试 结 合 JaCoCo 履 盖 率 


结合 履 兰 率 与 BVT 目 动 化 测试 ， 可 以 得 到 每 个 BVT 的 用 例 的 复 兰 
率 数 据 ， 从 而 得 出 几 个 纬度 的 结 


:可 以 通过 黎 兰 率 报告 看 出 目 动 化 测试 用 例 的 履 凋 情况 ， 从 而 调 
整 、 优 化 、 和 补充 测试 用 例 。 


可 以 动态 映射 自动 化 测试 用 例 与 源 代码 的 关系 ， 从 而 可 以 按 方 法 
的 调用 频繁 度 来 优化 代码 ， 优 化 调用 频繁 度 高 的 代码 ， 找 出 宛 余 代 
码 ， 等 等 。 需 要 注意 的 是 ， 用 例 和 代码 的 动态 映射 关系 ， 可 能 会 存在 
映射 到 的 画 数 比较 多 的 情况 ， 因 此 建议 根据 功能 有 针对 性 地 筛选 出 重 
点 画 数 来 做 映射 。 


BVT 与 履 盖 率 进行 结合 ， 主 要 包括 以 下 几 个 步 又 。 
1) 在 BVT 用 例 中 插入 覆盖 率 方法 


应 用 宝 的 BVT 用 例 基于 Robotium 框 染 编 写 ， 有 setUp 及 tearDown 回 
有 生命 周期 ， 因 此 要 收集 单个 用 例 的 覆盖 率 数 据 ， 可 以 在 setUp 时 重 置 
清理 之 前 旧 的 窗 盖 率 数 据 ， 如 代码 清单 9-14 所 示 。 在 用 例 执 行 过 程 中 收 


集 到 禾 盖 率 数 据 后 ， 在 tearDown 中 dump 出 覆盖 率 数 据 ， 如 代码 清单 9- 
15 所 示 。 


代码 清单 9-14 ”setUp 时 清理 之 前 旧 的 窗 访 率 数 据 


@override 
protected void setUp() throws Exception { 
Super .SetUp()， 
/ /反射 调 


JaCoCO API 的 


reset 方 法 


Method methodDump = classAgent.getMethod("reset"); 
methodDump.invoke(objAgent, null) 


代码 清单 9-15 tearDown 时 dump 出 覆盖 率 数 据 


@Override 
protected void tearDown() throws Exception { 
/ /反射 调 


JaCoCo api 的 


dump 方 法 


Method methodDump = classAgent.getMethod("dump",boolean.class); 
methodDump.invoke(objAgent, reset ) ， 


} 


2) 执行 BVT 用 例 ， 得 到 履 兰 率 


运行 BVT 的 用 例 ， 用 例 执 行 完成 后 输出 覆盖 率 文 件 ， 一 个 用 例 对 
应 一 个 获 盖 率 文件 〈 图 9-18) 。 


L| test76410817_FloatWindo... (93 KB 


口 test76410867 _AppDetail .. (87 KB 
品 test76410903_AppDetail ... (87 KB 
LD) test76410919 Search_Clic... (87 KB 
口 testMgr_InstalledAppMan... (93 KB 


| testSettingChild_Personal.. (83 KB 


口 testSetting_AutoDelPacka... (83 KB 


口 testSetting_WiFiBookingW... (83 KB 


L] test76410829_FloatWindo... 
[ test76410893_MiniDeskto... 
LD test76410913 Search Ent... 
口 test76410957_Mgr_Mobil... 
LL testSearch_ClearSearchHis,.. 


testSettingChild_PhoneMa,,. 


(94 KB) 
(87 KB) 
(87 KB) 
(92 KB) 
(87 KB) 


(83 KB) 


口 testSetting_AutolInstall.ec (83 KB) 


| test76410831_FloatWindo,.. (94 KB) | | test76410859_AppDetail_... 


L | testMgr_ClickAppUninstall.. (92 KB) | | testMgr InstalledApPMan.… 


图 9-18 BVT 生成 的 履 盖 率 文 件 列表 


3) 批量 生成 覆盖 率 报告 ,解析 入 库 


将 上 面 的 EC 文件 批量 生成 履 盖 率 报 告 ， 生 成 XML 格式 的 报告 ， 


[test76410895_MiniDeskto... (88 KB) [] test76410897_MiniDeskto... 
Ltest76410915 Search Ent.. {87 KB) | | test76410917 Search Clic... 


LtestSearch_ClickAppiInRes... (87 KB) | | testSearch_ClickTabsInRes,,. 
| |testSettingChild_Recomm,.,. (83 KB) | ] testSettingChild_Software.. 


| | testSetting_FloatWindow.ec (83 KB) | | testSetting_NoPictureMod... 


(87 KB 
(88 KB 
(87 KB 
(92 KB 
(87 KB 
(83 KB 


(83 KB 


根 


据 XML 的 文件 格式 (图 9-19) ， 我 们 设计 出 四 张 表 ， 每 个 用 例 的 履 盖 
率 文 件 分 别 入 四 张 表 :，testcase 表 、package 表 、class 表 、method 表 ， 记 
录 存 储 的 束 是 XML 里 面 的 内 容 ， 通 过 解析 程序 将 这 些 记录 全 部 入 库 。 


履 本 report 
… 名 report 
一 者 nane 


由 - .加 sessioninfo 
el DO package 


H.C counter 
-DD counter 
一 加 countez 
.一 counter 
-BB counter 
BB counter 


HD) sourcefile 
“0 sourcefile 
HD sourcefile 
-DD sourcefile 
-0 sourcefile 
4 counter 
“BD counter 
针 counter 
1 counter 


图 9-19 Jacoco 生 成 的 XML 格式 


4) 分 析 履 盖 率 结果 ， 得 出 用 例 和 代码 映射 关系 


我 们 已 经 得 出 每 一 个 BVT 用 例 的 覆 届 率 数 据 ， 下 面 对 每 一 个 复 兰 
率 数 据 结 朱 进行 分 机 ， 这 个 是 比较 关键 的 点 ， 步 又 如 下 : 


用 例 - 包 ~ 类 一 方法 的 黎 音 数据， 重点 找 出 method 表 的 coverd 的 
数据 。 


method 表 数据 : 和 饶 选 出 method_coverd=1 的 所 有 数据 。 
.根据 上 面 的 数据 再 次 盘 选 。 


我 们 发 现 method_coverd=1 的 所 有 数据 也 非 第 多 ， 一 个 用 例 往往 对 
应 几 千 个 方法 ， 这 些 方 法 真 的 都 是 我 们 要 找 的 对 应 的 方法 吗 ? 答案 旦 
否定 的 。 在 一 个 用 例 的 执行 过 程 中 ， 内 存 中 往往 会 有 其 他 方法 在 执 
行 ， 这 部 分 数据 也 会 一 起 记录 进来 ， 我 们 需要 把 这 些 方法 剔除 出 去 ， 
比如 构造 方法 、 定 时 任务 、Server 的 触发 等 ， 再 根据 用 例 对 应 功能 的 竺 
上 护 ， 沛 先 出 属于 该 功能 对 应 的 代码 package 范 围 ， 最 终 形成 一 个 比较 精 
简 的 用 例 和 代码 映射 天 系 。 


2. 过 异 履 兰 率 和 全 量 履 兰 率 


根据 才 兰 率 结 永 ， 黎 将 率 可 以 分 为 差异 履 


和 
蔷 
Ea 
[由 
出 
测 
用 
区 


-差异 覆盖 率 : 改动 点 的 代码 执行 履 盖 率 情 况 。 


主 异 禾 兰 率 主 要 是 根据 开发 代码 变更 的 diff 关 异 ， 得 出 改动 代码 的 
范围 ， 然 后 根据 这 个 范围 有 针对 性 地 只 生成 这 部 分 改动 的 代码 覆盖 率 
结果 。 通 过 履 盖 率 结果 反 向 衡量 测试 的 充分 性 ， 更 好 地 和 精准 评 佑 的 
测 弃 范 围 去 做 比较 。 


-全 量 上 覆盖 率 : 本 次 测试 代码 执行 全 部 覆盖 率 情况 。 


全 量 覆 盖 率 即 全 部 代码 的 覆盖 结果 ， 不 一 定 要 全 部 去 分 析 ， 只 需 
关注 改动 部 分 及 其 耦合 功能 的 覆盖 情况 即 可 。 


当 BVT 用 例 执行 完成 并 收集 到 和 覆盖 率 后 ， 使 用 哪 种 覆盖 率 古 由 测 
试 阶段 的 内 容 决 定 的 ， 比 如 上 线 前 测试 、 集 成 或 合流 阶段 ， 主 要 关注 
的 是 改动 点 的 变化 ， 使 用 差异 覆盖 率 效 果 比 较 理 想 。 如 有 果 是 新 增 功 
能 ， 则 使 用 全 量 履 兰 率 比较 理想 。 


3. 衡 量 黎 次 率 结 采 


代码 履 雷 是 一 种 状态 指示 器 ， 而 不 古稀 量 性 能 或 正确 性 的 单元 。 
代码 履 盖 率 是 给 程序 员 参 考 用 的 ， 是 让 程序 员 发 现代 码 中 间 题 的 一 种 
手段 ， 可 以 发 现 过 时 的 、 未 测试 的 类 ， 还 可 以 发 现 未 经 测试 执行 可 能 
导致 问题 的 路 径 。 在 实际 项 目 中 ， 代 码 履 盖 率 总 是 低 于 100%。 取 得 完 
全 覆 志 十 不 可 能 的 ， 如 琳 取 得 ， 那 也 是 非常 罕见 的 。 分 析 前 一 定 要 确 
定 哪 些 为 必须 获 深 ， 哪 些 为 可 以 或 不 窗 盖 ， 不 要 为 了 窗 协 而 敌 益 ， 代 


码 逻 辑 的 熟练 程度 对 分 析 徐 盖 率 会 有 很 大 的 帮助 ， 一 定 要 先 梳理 清 


楚 。 


4. 基 于 和 窗 蓄 率 数 据 分 析 用 户 喜 好 


除了 本 小 世人 介绍 的 覆 副 率 各 规 应 用 外 ， 还 可 以 进行 发 艇 性 应 用 ， 
例如 基于 获 兰 率 数 据 来 分 析 用 户 喜 好 。 


在 应 用 中 我 们 添加 一 个 测试 服务 ， 定 时 地 收集 窗 盖 率 数 据 并 上 传 
到 后 台 服 务 嚣 中。 后台 收 集 这 部 分 数据 ， 只 取 coverage=1 〈 即 已 覆盖 的 
数据 ) ， 按 其 三 个 纬度 存储 ( 包 、 类 、 方 法 ， 把 所 有 的 数据 进行 一 
下 统计 ， 会 得 出 三 个 纬度 的 总 数据 ， 格 式 如 下 (表格 里 的 数据 只 是 举 
例 ， 无 参考 价值 ) : 


包 已 覆盖 数据 
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按 次 数 优 先 级 做 一 个 正 序 ， 就 可 以 得 到 该 用 户 操作 频繁 度 由 高 到 
低 的 一 个 列表 ， 将 这 些 按照 我 们 积 系 的 知识 库 划 分 归 类 ， 束 可 以 得 到 
该 用 户 功 能 使 用 高 低 的 列表 。 功 能 上 覆盖 率 低 的 可 以 考虑 淡化 和 去 掉 ， 
功能 窗 盖 率 高 的 可 以 考虑 优化 和 新 增 功能 。 


9.5.5 ”指导 建议 


代码 上 黎 兰 率 是 软件 测试 中 的 一 种 度量 手段 ， 主 要 用 来 措 述 程序 中 
源 代码 被 测试 的 比例 和 程度 。 在 单元 和 系统 测试 过 程 中 ， 其 常 钊 作为 
衡量 测试 好 坏 的 指标 ， 甚 至 在 很 多 情况 下 用 代码 覆盖 率 来 考核 测试 任 
务 完成 情况 ， 经 常会 被 要 求 代码 禾 兰 率 必 须 达 到 xx% 以 上 ， 才 算 测试 
充分 。 于 是， 测试 人 员 或 者 开发 人 员 费 尽心 思 设 计 案 例 来 覆 凋 代码， 
这 种 用 代码 履 吉 率 来 衡量 的 方法 ， 有 利 也 有 弊 。 


以 下 是 给 读者 的 一 些 建议 : 


- 覆 兰 率 数 据 只 能 代表 你 测试 过 哪些 代码 ， 不 能 代表 你 测 好 了 这 些 
代码 。 


不 要 过 于 相信 禾 盖 率 数据 。 
不 要 只 拿 语句 / 行 覆 盖 来 衡量 。 
-路径 黎 盖 率 > 判断 覆盖 > 语句 覆盖 。 


:不 要 言 目地 为 了 提供 罗 兰 率 而 补充 用 例 ， 应 该 想 办 法 设计 更 好 的 
用 例 ， 哪 伯 多 设计 的 用 例 对 有 覆盖 率 提升 没有 效果 。 


9.6 ”本 章 小 结 


本 章 从 测试 工程 、 测 试用 例 、 测 试 报告 、 跨 应 用 、 代 码 履 盖 率 等 
多 种 角度 来 介绍 基于 Instrumentation 的 自动 化 测试 及 在 应 用 宝 BVT 中 的 
应 用 。 在 这 一 过 程 中 涉及 Robotium、Spoon、UiAutomator、JaCoCo 等 
技术 或 框架 ， 从 中 也 可 以 看 出 自动 化 测试 在 一 个 项 目 实际 实践 中 往往 
是 结合 多 种 技术 与 框架 的 ， 而 基于 Instrumentation 的 自动 化 测试 ， 由 于 
测试 代码 本 身 以 APK 形 式 安装 在 手机 中 ， 测 试 工程 也 可 以 方便 地 调用 
Android 平 台中 丰富 的 类 库 ， 例 如 通过 Intent 发 送 广播 、 创 建 后 台 
Services 进 行 监控 、 数 据 库 读 写 、 切 换 网 络 等 。 男 外 ， 代 码 履 盖 率 不 仅 
可 以 应 用 到 自动 化 测试 过 程 中 ， 手 工 测 试 也 非常 适合 使 用 ， 尤 其 对 于 
新 功能 的 覆盖 ， 其 作用 不 言 而 喻 。 我 们 只 有 在 实践 过 程 中 放 开 思维 ， 
才能 创造 更 多 可 能 。 


第 10 章 ”兼容 性 测试 实践 


本 章 从 三 个 纬度 对 兼容 性 测试 进行 了 介绍 。 首 先 介绍 兼容 性 测试 
定义 ， 然 后 依次 介绍 手动 测试 方法 、 自 动 化 测试 方法 、 云 平台 测试 方 
法 ， 如 图 10-1 所 示 。 


概述 - 兼容 性 测试 定义 


手动 测试 一 介绍 手动 机 型 测试 的 策略 
测试 方法 | 自动 化 测试 一 介绍 几 种 自动 化 方法 ， 还 有 开源 平台 使 用 介绍 
并 容 性 测试 实 成 云 平 台 测试 一 业界 主流 的 云 平台 使 用 介绍 
思考 一 对 现 有 方法 的 思考 


回顾 一 对 本 章 重 点 内 容 回 顾 


图 10-1 本章 知 识 结构 图 


羔 容 性 测试 的 方法 很 多 ， 无 论 古 手动 、 目 动 化 还 是 云 平台 ,都 只 
征 手 段 。 我 们 必须 从 实际 收益 出 发 ， 来 选择 适合 项 目 本 吴 的 方法 。 


10.1 兼容 性 测试 概述 


兼容 性 测试 主要 是 指 测试 Android 应 用 的 功能 ， 在 市 面 上 所 有 的 


Android 设 备 上 能 否 正 常 运行 。 


为 什么 主要 是 Android 而 不 是 i0S 呢 ?大 家 想 一 下 ， 大 部 分 测试 人 
员 所 知 的 iOS 设 备 会 超过 50 款 吗 ? 很 显然 不 会 超过 。 但 是 ， 你 所 知 的 
Android 设 备 会 少 于 50 款 吗 ? 管 案 很 明显 了 。2015 年 10 月 ， 中 国 Android 
手机 市 场 在 售 机 型 数量 达到 1144 款 ， 雄 片 化 非常 严重 ， 如 图 10-2 所 示 。 


图 10-2 ”2015 年 10 月 中 国 Android 机 型 碎片 化 程度 


之 所 以 做 机 型 兼容 性 测试 ， 主 要 原因 有 以 下 几 方 面 : 


:设备 碎片 化 : 2015 年 Android 机 型 增加 了 60%， 达 到 18679， 这 个 
数字 更 是 2012 年 的 4 倍 多 。 


-品牌 碎片 化 : 三 星 占 比 最 高 ， 有 439% 的 份 笑 ， 中 国 品牌 排名 靠 前 
的 有 人 华为、 联想、 中 兴 、 小 米 、OPPO 等 。 


系统 碎片 化 ，Android 的 不 同 版 本 分 布 情况 严重 。 
.传感器 碎片 化 ， 传 感 器 品种 越 来 越 丰富 。 


屏幕 碎片 化 : Android 的 屏幕 太 才 规格 众多 。 在 这 种 碎片 化 中 ， 你 
的 App 说 不 好 会 落 到 哪个 坑 里 面 。 也 许 是 某 个 特殊 屏幕 分 辨 率 ， 或 者 是 
某 个 特殊 的 传 感 苍 API。 


-动态 skia; 封 痛 中 间 层 ， 动 仿 调用 系统 鲨 染 API， 要 做 机 型 履 兰 。 


-静态 skia; 打包 所 有 系统 接口 ， 静 仿 系 统 泻 染 API， 要 做 机 型 覆 


a 


.游戏 引擎: Canvas 游戏 、Egret3 引 | 苟 用 到 GPU 的 OpenGL 接 口 做 人 硬件 
加 速 ， 要 做 机 型 履 盖 。 


AndroidL: 新 系统 文 持 ， 要 做 机 型 禾 兰 。 


特性 代码 中 用 到 了 机 器 本 和 喘 的 硬件 接口 ， 由 于 机 右 的 多 样 性 、 肥 
异性 ， 一旦 代码 对 某 类 接口 有 所 遗漏 或 者 处 理 不 当 ， 束 会 出 现 各 种 异 


丝 


10.2 ”兼容 性 测试 方法 


羔 容 性 测试 主要 有 手动 测试 、 目 动 化 测试 和 云 平 台 测试 三 种 方 
法 。 本 市 我 们 也 分 别 从 这 三 个 方面 进行 介绍 。 


10.2.1 手动 测试 
兼容 性 测试 最 简单 的 ， 就 是 在 日 常 手工 测试 中 ， 按 照 一 定 的 策略 
进行 测试 。 具 体 有 哪些 策略 呢 ? 


(1) TOP 机 型 覆盖 。 例 如 ， 在 手机 QQ 浏览 器 (Android) 测试 
中 ， 通 常 笔 者 在 “迭代 测试 ?阶段 采用 当前 Android TOP 50 (数据 来 源 : 
产品 经 理 ) 机 型 。 在 “上 线 前 ”测试 中 ， 笔 者 缩小 范围 ， 采 用 TOP20 机 型 
进行 测试 。 


(2) 差异 机 型 。 移 分 析 得 出 机 器 差异 性 在 于 GPU， 再 根据 对 GPU 
品牌 型 号 的 分 析 ， 做 精准 覆 副 。 例 如 : 


:高 通 GPU 的 机 器 可 以 主要 禾 盖 Adreno 200 和 Adreno 203， 基 本 占 高 
通 总 数 的 60%。 


Imagnition: GPU 的 机 器 主要 和 窗 盖 SGX544+ 和 SGX531， 约 占 该 品 
牌 总 数 的 65% 。 


.Mali: 和 窗 盖 Mali-400MP， 占 72%。 


用 上 述 GPU 的 机 器 ， 在 测试 中 重点 窗 盖 。 


(3) 已 有 BUG 分 析 的 机 型 覆盖 。 通 过 对 手机 QQ 浏 唤 器 
(Android) 现 有 BUG 库 中 机 型 问题 进行 归纳 汇总 ， 笔 者 得 到 了 表 10-1 
中 的 内 容 。 


表 10-1 手机 QQ 浏览 器 (Android) 机 型 BUG 总 结 


类 别 浏览 器 功能 划分 机 型 覆盖 重点 
GPU 
Egret 引擎 GPU 


Cocos 引擎 


Laya 引 警 
静态 skia : 统 + 特殊 机 型 库 
动态 skia 统 + 特殊 机 型 库 


- 方 字体 显示 统 +TOP 字体 


功能 类 


~ 
, | 


洪 


AndroidL 


ts 
cy 


Mtt~ 


Er 


兴办 | 淮 
< 


( 续 ) 
类 别 浏览 器 功能 划分 机 型 覆盖 重点 
快速 纹理 上 传 系统 
国有 2.X 软 绘 +4.X 软 绘 +4.X 硬 绘 
功能 类 | i 
分 状 率 
性 能 类 中 低 端 机 器 


流畅 性 中 低 端 机 器 


10.2.2 ”自动 化 测试 


现在 业界 主流 机 型 兼容 目 动 化 思路 ， 和 是 利用 多 机 型 云 乎 台海 量 的 
设备 进行 被 测 App 的 安装 秋 载 、 稳 定性 、 功 能 测试 等 测试 。 本 节 主 要 介 
绍 目 动 化 实现 部 分 ， 云 平台 使 用 部 分 在 下 一 世人 介绍 。 


1. 安 闭 和 卸载 


通过 在 Android 设 备 上 安装 被 测 应 用 一 启动 被 测 应 用 -种 载 被 测 应 
用 ， 来 检验 以 下 两 方面 内 容 。 


1) 安装 包 的 安装 兼容 性 


典型 例子 是 ， 在 Android2.X 系 统 上 ， 如 果 App 中 method 方 法 数 超过 
65K (65535) ， 就 会 出 现 安装 失败 。 根 本 原因 是 安装 APK 的 时 候 ， 
Android2.X 的 做 dexopt 使 用 LinearAlloc 回 定 5MB 空 间 存 储 方法 数 ， 所 以 
有 方法 数 65K (65535) 这 个 限制 。 具 体 实现 原理 方法 如 下 : 


通过 adb (Android Debug Bridge) 进行 安装 和 印 载 。 例 如 : 安装 包 


test.apk， 包 名 com.sample.app， 局 动 Activity 是 MainActivity。 
安装 : adb install test.apk 。 


局 动 : adb shell am start-n com.sample.app/.MainActivity ° 


和 扼 载 : adb uninstall testapk。 
履 盖 安装 : adb install-r test.apk 。 


通过 上 述 命令 ， 进 行 App 安 装 、 局 动 、 秋 载 。 观 察 console 输 出 ， 如 
果 是 success 束 是 成 功 ， 反 之 束 是 失败 。 同 时 抓 取 Logcat， 提 供给 开发 人 


Dail 


2) 通过 启动 被 测 应 用 ， 检 测 启动 crash 等 低级 致命 问题 


通过 对 Logcat (DDMS 中 工具 ) 打印 内 容 进行 监控 ， 查 找 Java 层 和 


Native 层 Crash 信 息 。 
Java 层 Crash 信 息 如 下 : 


E/AndroidRuntime( 1857): FATAL EXCEPTION: main 

E/AndroidRuntime( 1857): java.lang.RuntimeException: Unable to create 

service com.sample.app.internal.protocols.ProtocolsPpackService: java.lang. 
RuntimeException: Unable to register protocol, service is dead 
E/AndroidRuntime( 1857): at android.app.ActivityThread.handleCreateService(Act 
ivityThread.java:2373) 

E/AndroidRuntime( 1857): at android.app.ActivityThread.access$1600 
(ActivityThread.java:130) 


Native 层 Crash 信 息 如 下 : 


大 炎炎 大 大 大 大 大 大 炎炎 类 大 大 大 大 大 大 大 大 大 炎炎 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大大 大 大 大 大 大 大 大 


Build fingerprint: 'XXXXXXXXX' 

pid: 1658, tid: 13086 >>> com.sample.app <<< 

signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 64696f7e 
r9 00000000 ri 00000001 r2 ad12d1e8 r3 7373654d 

r4 64696f72 r5 00000406 r6 00974130 r7 40d14008 

r8 4b857b88 r9 4685adb4 10 00974130 fp 4b857ed8 

ip O00000000 sp 4b857b50 lr afd11108 pc ad115ebc cpsr 20000030 


如 果 Crash 的 Trace 信息 中 包含 被 测 App 的 包 名 (com.sample.app) ， 
那么 这 个 Crash 束 是 被 测 App3 引 起 的 。 


2. 稳 定性 


为 了 测试 App 在 各 种 不 同 机 型 上 的 稳定 性 ， 通 过 工具 测试 进行 数 小 
时 测试 ， 发 现 Crash 问 题 。 业 界 主 要 通过 两 种 方法 进行 测试 ， 具 体 如 
个 : 


1) 控件 志 历 测试 
现在 业界 测试 实现 方法 基本 包谷 以 下 儿 个 步 又 。 
(1) 获取 当前 被 测 App 的 所 有 控件 方法 见 表 10-2。 


表 10-2 ”获取 当前 被 测 App 的 所 有 控件 方法 


获取 方法 原理 
UIAutomator Android4.1 及 上 版 本 通过 uiautomator dump 命令 ， 获 取 当 前 控件 Tree 结构 的 xml 
(API 16) 进行 解析 获得 
Hierachy Viewer 所 有 Android 版 本 将 从 Hierarchy Server 获取 的 dump 信 息 组 成 自己 的 控件 
Tree 结构 
Robotium 所 有 Android 版 本 详 见 3.3.3Robotium 实践 运用 


(2) 采用 某 种 算法 人 遍历 App 中 获取 的 控件 ， 基 于 二 叉 树 遍历 算法 
改进 而 来 。 注 意 点 击 控件 后 ， 当 前 控件 树 发 生变 化 。 


(3) 针对 忆 历 到 的 控件 进行 相应 操作 ， 方 法 见 表 10-3 。 


表 10-3 ”对 控件 进行 操作 方法 


操作 方法 适用 范围 原理 
UIAutomator Android4.1 及 以 上 版 本 (API 16) 详 见 5.3UIAutomator 实战 


Robotium 所 有 Android 版 本 详 见 3.3.3Robotium 实践 运用 


Input 命令 Android4.1 及 以 上 (API 16 ) 运行 Android 系统 自 带 input 命令 实现 
2) Monkey 随 机 测试 


运行 Android 原 生 稳 定性 测试 工具 Monkey， 通 过 ADB (Android 
Debug Bridge) 实现 。 详 见 4.2 Monkey 测 试 方法 。 


3. 功 能 测试 


在 手机 QQ 浏览 器 (Android) 项 目 中 ， 搭 建 了 一 套 自动 化 工具 。 通 
过 编写 功能 测试 自动 化 脚本 ， 在 内 部 云 平 台 设 备 上 运行 。 自 动 化 框架 
如 图 10-3 所 示 。 


但 是 ， 在 这 个 自动 化 过 程 中 ， 一 个 难点 出 现 了 。 这 束 是 验证 点 如 
何 确认 的 问题 ， 如 图 10-4 所 示 。 


当 你 面 对 图 10-5 这 样 的 测试 结 末 ， 如 琳 仅 仅 通 过 文字 判断， 结果 是 
完全 正确 的 。 但 是 ， 你 能 承认 结 末 是 正确 的 吗 ? 很 显然 不 能 。 因 为 至 
如 


问题 的 关键 在 于 : ”自动 化 无 法 验证 复杂 的 界面 闫 色 、 布 局 、 背 景 


一 /一 


如 何 破 解 呢 ?从 投入 产 出 比 来 看 ， 笔 者 采用 目 动 化 运行 ， 人 工 验 
证 结果 (截图 ) 的 半自动 化 方式 。 


“统一 入口 
@ - 全 且 人 下 测试 任务 管理 。 [KDB 过 接手 祁 》 
< 云 用 户 | | ' = 
Co ls -一 -一 


Dr 
4 任务 Server ! 控制 Server ! 结果 DB 


|. 新 建 /修改 /删除 任务 } 
:… 运行 任 7 

| 停止 任务 

"任务 结果 


(®) 


Wi-Fi 接 和 人 点 


图 10-3 QQ 浏览 器 (Android) 机 型 兼容 自动 化 框架 
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编写 功能 


最 后 效果 如 图 10-5 所 示 。 


10 人 手工 测试 10 台 机 器 


RE TY TY Ta 
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1 人 看 10 台 机 器 结果 
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图 10-5” ”人工 半自动 化 验证 结 
本 方案 有 两 个 关键 点 ， 云 平台 + 自动 化 框架 。 
: 云 平 台 : ”笔者 选择 腾讯 公司 内 部 Kapalai 平 台 作 为 云 平台 实现 。 


` 目 动 化 框架 : 笔者 选取 腾讯 公司 内 部 最 流行 的 Android 开 源 框架 选 
择 QQDriver 作 为 目 动 化 实现 技术 。 


QQDriver 的 测试 用 例 结构 如 图 10-6 所 示 。 


对 上 图 所 示 各 项 说 明 如 下 : 


TestSuite: 测试 用 例 集 合 ， 类 似 Junit 的 TestSuite 方 式 管理 用 例 。 


Case: 测试 用 例 ， 每 个 测试 用 例 中 可 以 有 很 多 CP (CheckPoint 检 查 
点 ) 。 


CP: CheckPoint 检 查 点 ， 每 个 检查 点 对 应 一 张 手机 截图 。 


Result.xml: 在 这 个 文件 中 会 记录 Case、CP 和 截图 之 间 的 映射 关 
系 。 这 样 的 映射 关系 方便 测试 结果 录入 DB 进行 管理 和 展现 。 


TestSuite 


图 10-6 ”QQDriver 的 测试 用 例 结构 


整个 方案 运行 结果 如 图 10-7 所 示 。 


左 线 反馈 0 殉 玉 ciro| 退 出 登录 
3 熊猫 测试 系统 首页 ”机 型 兼容 测试 。 覆盖 安装 测试 。 性 能 测试 ”帮助 与 支持 
您 的 位 置 : 首页 > 机 型 兼容 测试 ”机 型 列表 

《sgID 用 /" 机 器 | 用例 总 数 成 功用 例 数 | 失败 数 未 执行 数 | 必用 可 序 居 百 详情 | log 

OPPO N1T 6 6 0 0 0 查看 详情 下 载 

Meizu M353 6 6 0 0 0 查看 详情 下 载 

samsung CT-19260 6 6 0 0 0 查看 详情 下 载 

HTC HTC 9088 6 6 0 0 0 查看 详情 下 载 

samsung GT-I8262D 6 6 0 0 0 查看 详情 F 载 

samsung GT-I9300 6 6 0 0 0 查看 详情 下 载 

samsung GCT-I9128 6 6 0 0 0 | 查看 详情 下 载 


图 10-7 整个 方案 运行 结 


按照 测试 用 例 组 织 ， 截 图 半 目 动 确认 界面 如 图 10-8 所 示 。 


送 配 结果 - 每 日 头条 - 美 图 下 滩 0 


R21T[Kapslsi] MITIkKspalai] . GHo002 [Kapalei] 


图 10-8 ”截图 半 目 动 确 认 界 面 
4) 开源 自动 化 平台 


业界 主流 多 机 型 开源 上 自动 化 平台 ， 是 在 GitHub 上 的 STF 
(https://github.com/openstf/stf/ ) ， 如 图 10-9 所 示 。 


图 10-9 ”STF 主 界面 


其 主要 特性 包括 : 

文 持 Android2.3.3 (API Level 10) 到 Android N (API Level 23) 。 
无须 手 机 Root 。 

文 持 屏幕 实时 操作 ， 例 如 : 点 击 、 输 入 、 拖 动 等 。 

- 拖 放 安 装 APK 。 

.ADB Remote Debug。 

.基于 ADB Remote Debug 的 自动 化 。 


搭建 STF 平 台 的 步骤 如 下 : 


主意 : 本 教程 在 Mac X 一 体 机 (OS 10.9) 上 实验 通过 。 其 他 操作 
系统 ， 如 Linux、Windows 官 方 暂 未 给 出 详细 文档 ， 暂 不 介绍 。 详 细 信 
息 请 参考 官方 文档 安装 指南 。 


(1) 安装 Brew (http://brew.sh/index_zh-cn.html ) 工具 。 在 终端 窗 
口 输入 命令 代码 如 下 : 


/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/ 
install/master/install)" 


注意 : 内 网 用 户 需 要 配置 curl 和 git 的 外 网 proxy 才 能 访问 。 


(2) 安装 所 有 依赖 组 件 。 在 终端 窗口 输入 命令 代码 如 下 : 


brew install rethinkdb graphicsmagick zeromq protobuf yasm pkg-config 


主意 : 内 网 用 户 请 输入 外 网 proxy 命 令 代 码 如 下 : 


http_proxy=http://<proxy-server>:<proxy-port> brew install rethinkdb 
graphicsmagick zeromq protobuf yasm pkg-config 


(3) 安装 NPM (https://www.npmjs.com/ ) 。 在 终端 窗口 输入 命令 
代码 如 下 : 


brew install npm 


内 网 用 户 请 输入 外 网 proxy 命 令 代 码 如 下 : 


http_proxy=http://<proxy-server>:<proxy-port> brew install npm 


(4) 安装 STF 的 NPM 包 。 在 终端 窗口 输入 命令 代码 如 下 : 


npm install -g stf 


主意 : 内 网 用 户 请 输入 外 网 proxy 命 令 代码 如 下 : 


npm config set proxy http://<proxy-server>:<proxy-port> 


(5) 点 击 “Download ZIP” 下 载 最 新 master 主 线 STF 代 码 ， 如 图 10- 
10 所 示 。 


[] openstf / stf 


《> Code (Dlssues 85 1 Pull requests 7 Ed Wiki _- Pulse 
Control and manage Android devices from your browser. https://openstf.io 


CD 1,798 commits PP 6 branches 


图 10-10 ”STF 代码 下 载 


(6) 解压 并 进入 源码 根 目录 ， 安装 。 在 终端 窗口 依次 输入 合 
令 代 码 如 下 : 


cd Downloads/stf-master/ 
npm install 
npm link 


/本 


注意 ”内 网 用 户 在 npm link 之 前 需要 配置 bower 和 git 的 proxy 。 
(1) 在 下 载 的 stf 目 录 中 ， 编 辑 .bowerrc 。 

(2) 加 入 proxy": "http://<host>: <port>"。 

(3) 退出 并 保存 .bowerrc 文 件 。 

(4) 运行 命令 :git config--global url."https://".insteadOf git: //。 
(5) 如 果 这 里 失败 ， 再 多 试 几 次 ， 可 能 是 外 网 连接 不 稳定 。 
(7) 启动 rethinkdb 数 据 库 。 在 新 终端 窗口 输入 命令 代码 如 下 : 


rethinkdb 
(8) 启动 STF 平 台 。 在 新 终端 窗口 输入 命令 代码 如 下 : 


stf local --public-ip < 部 署 


server ip> 


(9) 将 手机 通过 USB 连 接 到 Mac X 一 体 机 上 。 注 意 : 可 以 通过 
USB Hub 扩 展 多 个 USB 接 口 。 


(10) 打开 浏览 器 访问 http://< 部 署 server ip>: 7100， 输 入 任意 用 
户 名 和 邮件 地 址 登录 。 


(11) 在 Devices 界 面 选择 一 部 手机 ， 如 图 10-11 所 示 。 


圆 Di 入 Deve 诚 3 和 @ 抬 助 
加 v 党 总 


cz 5892 GT-S7572 NX403A 


图 10-11 选择 一 部 手机 


(12) 进入 控制? 界面， 复制 Remote Debug 中 的 值 adb 
connect<ip>: <port>， 如 图 10-12 所 示 。 


图 口 控制 ss Devices Le 设 定 


we @ 基 二 
WW nttp’77 
5892~ 口 人 x 一 一 
1 回 pa 
小 中 自用 3.4 
上 传 App 
县 
WD 
国 Apps EE 疗 目 Remote debug © 
App Store 裔 定 
于 会 
辣 验 考 营 组 Apps WiFi 


四 Logs ”人 稳 更 专项 大 堆 图 。 具 自 动 化 和 进 阶 。 骆 楼 宗 浏览 到 主 Info 


Level  " 片 所 全 消 疹 


图 10-12 ”Remote Debug 值 


(13) 在 本 地 PC 的 CMD 窗 口中 输入 刚才 复制 的 值 “adb 
connect<ip>: <port>”， 如 图 10-13 所 示 。 


(14) 在 本 地 PC 的 CMD 窗 口中 输入 “adb devices” 查 看 远程 手机 连 
接 ， 如 图 10-14 所 示 。 


D:\>Yadb connect 10.20.73.131:7421 


connected to 10.20.73.131:7421 


图 10-13 ”adb 远 程 连接 手机 


D:\>adb deulces 
List of devices attached 
99bTecee deulce 


.131:7421 device 
.131:7405 devuice 


图 10-14 ”adb 远 程 连接 手机 


(15) 在 本 地 PC 的 CMD 窗 口中 通过 adb 命 令 可 以 进行 远程 自动 化 
操作 。 例 如 : 


:安装 APK 或 自动 化 脚本 : adb-s 10.20.73.131: 7405 push< 安 装 包 或 
者 脚本 包 APK>。 


.启动 APK 或 自动 化 脚本 : adb-s 10.20.73.131: 7405 shell am start- 


n< 包 名 >/.< 主 Activity>。 


:自动 化 结果 可 以 存在 手机 SD 卡 上 ， 通 过 : adb-s 10.20.73.131: 
7405 pull/sdcard/result.txt 进 行 拉 取 和 验证 。 


(16) 如 果 要 在 多 种 机 型 上 操作 ， 请 重复 步骤 (11) ~ (15) 即 
可 。 


10.2.3” 云 平台 测试 


本 章 通 过 介绍 业界 主流 的 云 平台 使 用 ， 帮 助 读者 快速 了 解 如 何 借 
台 实 现 兼容 性 测试 。 


1. 腾 讯 优 测 (http://utest.qq.com/ ) 


腾讯 优 测 作为 腾讯 对 外 提供 的 Android 手 机 平台 ， 在 业界 有 不 少 的 
用户 便 用 


(1) 用 QQ 账号 登录 ， 如 图 10-15 所 示 。 


企业 帐号 登录 RTX 登录 


帐号 密码 登录 
推荐 使 用 快速 安全 登录 ， 防 止 盗号 . 


支持 QQ 号 /邮箱 /手机 号 迪 录 


图 10-15 “腾讯 优 测 登 录 


(2) 点 击 菜单 “应 用 测试 ?进行 用 户 信息 认证 ， 如 图 10-16 所 示 。 


个 人 资料 完善 资料 即 可 获得 价值 100 元 的 测试 大 礼包 


图 10-16 ”腾讯 优 测 用 户 认 证 


(3) 上 传 APK 进 行 适 配 测 试 (请 使 用 Chrome 内 核 浏 览 器 ; ， 如 图 
10-17 所 示 。 


测试 项 


v 安装 /启动 /登录 /执行 / 扼 载 v 核心 场景 遍历 
v 运行 截图 w log 日 志 下 载 
Y 安装 时 间 / 启 动 时 间 /CPU/ 内 存 v 在 线 报告 


上 传 项 目 包 进 行 测试 


您 有 代金 券 示 领取， 立即 领取 


文件 : | 点 我 使 用 近期 历史 包 , 方便 快捷 


被 信 通知 : 园 测试 完成 微 信 通 知 查看 实例 


图 10-17 腾讯 优 测 上 传 APK 


(4) 点 击 “ 下 一 步 *， 进 入 机 型 选择 页 面 ， 如 图 10-18 所 示 。 


国 360 图 华硕 图 步步高 国 酷派 
国 有 呆 唯 国 全 立 国 Gigaset 国 广 信 
国 HTC 国 华为 国 联想 国 LG 

国 Letv 国 魅族 国 摩托 罗拉 加 努 比 亚 
国 一 加 国 OPPO 国 榨 石 国 PPTV 


回 华硕 


加 ASUS X002 
加 _X550 


国 _Z00UDB 


图 步步高 


图 10-18 ”腾讯 优 测 选择 机 型 


如 图 10-19 所 示 。 


版 本 测试 包 详情 


报告 编码 安装 包 版 本 提 测 时 间 设备 数 所 有 状态 器 


1200181 6.8.0.2510 2016-06-17 14:27:31 等 待 中 


935705 6.4.1.2055 2016-02-14 12:16:41 完成 


图 10-19 ”腾讯 优 测 提交 任务 


(6) 任务 完成 后 ， 查 看 任务 结果 ， 如 图 10-20 所 示 。 


CD 人 优 测 缺陷 分 析 。 ”应 用 测试 。” 云 手机 优 管家 。 优 社区 


让 测 区 责 简 音 


应 用 珊 战 ”性 务 列 大 任务 详情 


应 用 名 称 QQ 浏览 洲 应 用 大 小 20M 路 本 号 6.4.1.2055 
AN 去 持 系 


沅 Android 2,3 及 以 上 创 半 Bs 2016-02-14 12;16:4] 辣 来 时间 
更 远 闫 至 上 县 动 化 浊 渤 完成 准 撕 下 12 职 芝 用 户 数 632 万 


性 能 分 析 终端 详情 


Y 系统 版 本 


系统 版 本 问题 衙 述 要 苦 用 户 数 


Xlaomi MI 4LTE 和 wo 通过 蕊 


图 10-20 “腾讯 优 测 查看 任务 结 


(7) 点 击 “缺陷 分 析 ”-“ 适 配 分 析 ” “上 传 文件 ”， 如 图 10-21 所 


Y 详细 的 问题 机 型 


上 传 项 目 包 进行 测试 


您 有 代金 券 未 领 职 ， 立即 领取 


E77 


微 信 通 廊 ; 国 再 试 完 成 党 信 通 知 坦 看 实例 


图 10-21 腾讯 优 测 上 传 APK 文 件 


(8) 上 传 完成 后 ， 点 击 “ 提 交 扫 描 ”， 如 图 10-22 所 示 。 


图 10-22 ”腾讯 优 测 提交 扫描 


(10) 点 击 “ 详 情 ?查看 适 配 分 析 详细 信息 ， 如 图 10-23 所 示 。 


缺陷 分 怕 “任务 列表 ”问题 列表 


局 彩信 证人 208%) 目 
中 ee 7 4 
图片 问题 (1736) ) 
(10.42%) 


i 08%) 


FT 相机 问题 (10 4296) 
WiIRI 旺 (6.25%) rt 
控 神 问题 亿 08%) 一 一 


SDK 问 题 (74.19%) 


问题 概况 机 型 差 恒 问题 概况 


全 部 品牌 TY | | 全 部 型 号 | | 全 部 分 类 Y 
问题 现象 分 类 
Ditmap 类 珊 用 recyCIE 方 法 进行 资源 回收 时 去 史 啊 尘 他 司 片 的 尘 制 司 片 癌 梳 
Wif 热 点 的 setWifApConfiguration 方 法 被 系统 删除 导致 调用 时 出 现 异 党 crash WIFI 问题 
WIIBR 宗 的 SetWIIApConTguratnon 方 法 调用 时 出 现 民 常 写 致 crash WIFI 问 杆 
不 能 正常 开户 前 畦 概 像 头 相机 间 题 
从 数据 库 中 重启 快捷 方式 是 否 存 在 矢 败 点 画 问 置 


图 10-23 ”腾讯 优 测 适 配 分 析 详 细 信 息 


2.Testin ( ) 


(1) 注册 账号 登录 ， 如 图 10-24 所 示 。 


点 ”有 清 输 入 邮箱 


仗 请 输入 谈 码 


或 


条 QQ 登录 全 亿 司 登 孙 


让 没有 Testin 账 写 ”快速 注册 


忘记 密码 
图 10-24 ”Testin 注 册 账 号 登录 


(2) 点 击 “ 开 始 测试 ”， 上 传 安 装 包 ， 如 图 10-25 所 示 。 


我 的 测 起 | 开始 测试 | 
人 @ 完善 测 芭 信息 


上 传 安装 包 


应 用 正在 上 传 中 ， 请 不 要 关闭 浏览 器 


和 


qqbrowser 6.4.1.2055 20820.apk 
2% /120.5MB 取消 上 传 


图 10-25 ”Testin 上 传 APK 包 


(3) 输入 相关 信息 ， 点 击 “ 下 一 步 »， 如 图 10-26 所 示 。 


(4) 选择 “标准 兼容 测试 ”( 人 免费 ) ， 点 击 “ 提 交 测试 "， 如 图 10-27 
所 示 。 


(5) 点 击 “ 随 机 100 款 *"， 其 他 设置 如 图 10-28 所 示 。 


A QQ 浏览 器 EE2 


6.4 1.2055(Build 642055) 


更 换 图 标 
应 用 名 称 QQ 浏览 器 


应 用 类 别 


标准 鳞 容 测试 


图 10-27 ”Testin 选 择 测试 类 型 


随机 50 款 随机 100 款 


高 级 测 冻 选项 ， 


账号 不 互 跑 


Monkey 测 试 | @ 


* 开启 后 每 台 贫 型 档 遍 外 进行 30 秒 的 Monkey 列 试 


图 10-28 ”Testin 选 择机 型 数量 


(6) 点 击 “ 返 回 我 的 测试 *"， 点 击 “ 报 告 详情 "， 如 图 10-29 所 示 。 


(7) 下 拉 报 告 ， 点 击 “ 不 兼容 合计 ”中 的 数字 查看 不 兼容 机 型 详 
情 ， 如 图 10-30 所 示 。 


测试 记录 
应 用 服务 提 测 时 间 测试 概述 测试 报告 
QQ 浏览 器 i i 3 
Bk 兼容 测试 -随机 100 款 [应 用 ) 2016-02-14 12:28:58 (sew 报告 详情 


图 10-29 ”Testin 任 务 列表 


_ 不 兼容 数据 
行业 数据 : 应 用 -系统 安全 网 I 下 
不 兼容 合计 安装 失败 启动 失败 运行 失败 功能 异常 UI 异常 通过 待 优 化 
终端 数 医 避 | 0 0 1 0 0 99 0 
您 的 App 水 平 @ 影响 用 户 数 (万 ) 0 0 0 0 0 0 515 0 
占 比 (%) 1.00 0.00 0.00 1.00 Q00 0.00 99.00 000 
行业 平均 水 平 @ 占 比 (%) 10.64 276 0.00 7.87 0.00 0.00 8936 
行业 最 优 数据 【?) 占 比 (%) 0.00 0.00 0.00 0.00 000 0.00 100.00 


图 10-30 ”Testin 不 兼容 机 型 详情 


3. 百 度 云 (http://mtc.baidu.com/ ) 


(1) 点击“ 服务” “自动 化 测试 *"， 如 图 10-31 所 示 。 


测试 服务 问卷 服务 


自动 化 测试 


图 10-31 百度 云 上 自动 化 测试 


(2) 点 击 “ 全 面 兼容 测试 ">-“Android 测 试 ?， 如 图 10-32 所 示 。 


图 10-32 ”百度 云 全 面 兼容 测试 


(3) 点击“ 上 传 App 选 择 ” 上 传 被 测 App 包 。 选 择 50 款 热门 机 型 ， 点 
击 “ 立 即 购买 ” 免费) ， 如 图 10-33 所 示 。 


Ez = 


终端 兼容 测试 : 大 量 真 机 多 维度 出 试 ， 兼 容 性 测试 无 死角 


| qqbrowser 641.2055 20820.apk 100% | | | 


| 待 出 APP 测 试用 例 | 2 | 
注 :点 此 下 载 免费 工具 进行 测试 姥 本 录制 ， 如 需 帮 助 请 前 往 、、 


50 款 热门 机 型 


ciro.deng@qq.com| 


价格 ，- 尝 206- 元 每 各 手机 ¥4 元 ) 


实际 支付 。 半 0 元 免费 试用 


图 10-33 ”百度 云 上 传 被 测 App 包 


(4) 等 待 任务 执行 完毕 ， 点 击 “ 查 看 "显示 全 面 兼容 测试 报告 ， 如 


图 10-34 所 示 。 


QQBrowser ( 6.4.1.2055 ) -- 全 面 兼容 测试 报告 


| 测试 结果 
本 次 莱 容 性 测 汇 共 测 坛 46 款 机 型 ， 其 中 3 款 机 型 发生 anr,crash , 安 甘 失败 问题 
任何 蜂 问 谤 咨 询 ; mtc_ support@baiducom 


问 蚂 尖 昏 出 回 定 位 发 生机 型 玫 | 自 型 机 誉 
anf keyDispatchingTimedOut 1 MB526 
crash javalangAbstractMethodError 1 Lenovo A288t 


安装 失败 [INSTALL FAILED_DEXOpT Cooipad 8675 


| 终端 兼容 测试 结论 


65%, 


\ CI 测 ] 友 未 到 过 
3 


图 10-34 ”百度 云 全 面 兼容 测试 报告 


(5) 点 击 “ 深 度 遍 历 ” 测 试 ， 再 点 击 “ 创 建 ” 上 传 APK， 如 图 10-35 
所 示 。 


创建 任务 
终 庙 类 型 晶 ' Android 
其 本 信息 深度 请 历 济 h 东 ;这 这 在 主流 直 机 终 识 上 模 氟 直人 对 除 动 坟 用 的 LI 晶 作 行 为 ， 自 动 遍历 控件 从 而 发 现 程序 的 功能 问题 
配置 信息 * 上 伟 App : | qabrowser 6.4.1.2055 20820apk 74% 选 泽 
选择 最 近 上 传 的 App : QQBrowser6.4.1.2055 
加 华为 P4 ( androld 3.01 ) 脏 于 分 因 罕 : 192U"108U CPU ; 八 校 2UGHz 内 存 :36 
图 三 星 GT-N7100( Note 2) (android 4.12) 屏 节 分 辩 率 : 1280:720 CPU ; 四 核 1.6GHz 内 存 :2G 
邮件 通知 ; | 雪人 可 画 S03 人 ， 宅 个 邮件 请 用 半角 运 号 分隔 
购买 信息 价格 - 尘 二 9- 元 (每 sl¥5 元 ) 
实际 支付 。 半 曲 元 
立即 购买 


图 10-35 ”百度 云 深 度 遍 历 上 传 APK 


(6) 等 待 任务 完成 ， 点 击 “详情 "查看 深度 遍历 结果 ， 如 图 10-36 所 


| 测试 结果 
共 执 行 测试 项 2 个 没有 发 现任 何 问题 . 
| 基本 信息 


包 和 名 com.tencent.mtt 版 本 号 6.4.1.2055 


| 遍历 测试 
机 型 系统 版 本 分 辨 率 有 无 黑 边 有 无 重 影 ， 执行 结果 详情 
三 旺 N7100 ( Galaxy Note II ) android 4.1.2 720x1280 无 无 © 副 看 
查看 


华为 P8 android 5.0.1 1920x1080 无 无 © 


YY 


图 10-36 ”百度 云 深度 遍历 测试 结果 


(7) 点击“ 查看 ”， 查 看 遍历 截图 ， 如 图 10-37 所 示 。 


QQBrowser ( 6.4.1.2055 ) -- 深 度 遍历 测试 报告 


测 汪 结论 概述 | 日 志 截 图 
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人 
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西安 百名 蒙 面 人 春节 持 铁 锤 3 次 打 磺 工厂 
新 浪 同 


省 的 点 狐 改 击 副 运 站 会 生活 看 和 所 下 型 可 证 是 会 生 酒 
趟 末了 吉大 村 
下 [i DY 
淹 监 器 末 正常 退出 ,是否 你 复 上 次 沪 所 | x 浏览 器 未 正常 退出 ， 是 否 次 复 上 次 廊 六 科比 娇 妻 发 全 明 呈 黄 照 合影 乔丹 
同 的 网 页 7 和 | > 辣 的 网 页 了 
三 OQ 器 三 | 品 < > 三 AQ 品 


图 10-37 ”百度 云 深度 遍历 截图 
4. 云 平台 对 比 


笔者 对 以 上 介绍 的 云 平 台 在 功能 上 做 了 横 癌 对 比 ， 以 方便 读者 在 
项 目 中 选择 合适 的 工具 ， 见 表 10-4。 


表 10-4 云 乎 全 功能 横 癌 对 比 


特性 腾讯 优 测 Testin 百度 云 
适 配 分 析 惹 N 
漏洞 分 析 


手机 租用 


专家 测试 


训 过 

控件 遍历 可 Y i 
Y 落 
到 路 


5: 云 平台 收 迁 实 跨 


1) 典型 案例 


在 手机 QQ 浏览 器 皮肤 测试 中 ， 笔 者 区 通过 10.2.2 节 中 功能 自动 化 
发 现 了 问题 。 在 应 用 了 “地 福 吃 货 * 皮 肤 后 ， 发 现 三星 Nexus S 在 卡片 化 
页 面 时 ， 文 字 部 分 背景 变 为 透明 。 经 过 业务 人 员 测 试 确认 ， 是 个 特殊 
机 型 Bug， 如 图 10-38 所 示 。 


4 四 外衣 
加 川 大 英 食 下 赌 一 一 小 戌 门 
加 方 兴 来 又 的 泰 式 小 火 饭 
ED 时 星 鱼 火锅 来 半 
中 着 板 花 媒 分 不 清 。 口 其 粉 尾 局 炒 牛 河 局 鲜 鱼 鱼 火 名 来 克 ED 挟 芭 鱼 火锅 来 类 
可 蒂 甩 过 卡 -~ 口 最 浪 潘 的 故事 口 闯 板 花 版 分 不 清 ” 口 肠 粉 是 乌 炒 牛 ; 口 丢 概 花 板 分 不 消 “ 口 好 粉 奸 饮 炒 牛 河 


WE 为 -0 0 


川 大 美食 攻略 一 一 小 北 门 
EE3 方 兴 未 艾 的 泰 式 小 火锅 四 9 方兴未艾 的 泰 式 小 火锅 


突 全 站 碎 
bd 


邦人 人 人 


Samsung Nexus 5 samsung GT-19100 


LENOVO Lenovo K860i 


图 10-38 ”皮肤 机 型 问题 


本 方案 的 主要 收益 ， 源 于 缩短 在 多 人 台 手机 上 兼容 性 测试 时 间 。 通 
过 在 手机 QQ 浏览 器 (Android) 上 的 项 目 实践 ， 笔 者 得 到 如 下 数据 。 


2) 成 本 

目 动 化 建设 时 间 : 2 周 =80 小 时 x 人 

18 个 模块 脚本 编写 时 间 : 18x25=450 小 时 x 人 
共计 : 530 小 时 x 人 


由 于 平 合 建设 属于 固定 投入 ， 这 部 分 收益 通过 长 期 多 版 本 测试 进 
行 摊薄 ， 可 以 名 略 不 计 。 脚 本 编写 调试 时 间 是 主要 耗 时 ， 平 均 每 个 模 
块 需 要 25 小 时 x 人 。 当 然 ， 脚 本 可 以 通过 简单 修改 在 以 后 的 每 次 版 本 测 
试 中 复 用 ， 预 期 在 三 次 版 本 测试 后 ， 投 资 收益 基本 平衡 。 而 且 随 着 脚 
本 编写 水 乎 的 提高 ， 每 个 模块 的 完成 时 间 还 能 缩短 。 


3) 收益 


目 动 化 所 实现 的 验证 点 ， 占 手工 测试 验证 点 的 80%， 能 够 基本 蔡 代 
手工 测试 ， 如 图 10-39 所 示 。 


手工 测试 时 间 也 明显 缩短 ， 如 图 10-40 所 示 。 


手机 QQ 浏览 器 -兼容 测试 点 (单位 : 个 /版 本 ) 


1800 


手工 测试 


图 10-39 手工 测试 对 比 自动 化 收益 


手机 QQ 浏览 器 -兼容 测试 时 间 ( 单 位: 分钟) 


上 线 前 测试 
240 
国 自动 化 
手工 测试 
180 
集成 测试 
480 


图 10-40 手工 测试 对 比 自动 化 测试 时 间 


手机 QQ 浏览 器 项 目 组 在 “集成 测试 阶段 ?需要 测试 20 款 手机 兼容 
性 ， 从 上 图 中 统计 数字 可 以 看 出 ， 通 过 自动 化 , “集成 测试 阶段 兼容 测 
斌 时间” 缩短 了 60%, “上 线 前 兼容 测试 时 间 ? 缩 短 了 609% 。 


在 手机 QQ 浏 贤 絮 6.0 版 本 测试 中 ， 通 过 机 型 兼容 平台 ， 发 现 Bug 共 
计 30 个 ， 占 总 机 型 Bug 比 例 的 75%， 如 图 10-41 所 示 。 


手机 QQ 浏览 器 6. 0 机 型 Bug 分 布 


NC 


A 0 
| 


自动 化 


图 10-41 机 型 兼容 Bug 比 例 


10.3 ”兼容 性 测试 思 


UI 级 别 的 目 动 化 给 人 的 印象 一 直 束 是 “变化 太 大 ， 收 和 益 太 低 ”。 一 
旦 UI 发 生 了 较 大 变化 ， 之 前 的 目 动 化 脚本 束 会 有 较 大 改动 ， 投 入 高 ， 
收益 低 。 


皇 么 破解 这 个 难题 ? 思路 如 下 : 


:降低 建设 成 本 笔者 以 编写 日 动 化 脚本 为 例 ， 首 先 ， 选 择 一 个 低 
学 习 成 本 而 且 高 效率 的 框架 很 重要 。 其 次 ,不 断 地 素 计 公共 函数 ， 让 
脚本 开发 速度 提升 数 倍 。 


-提高 使 用 频率 : 目 动 化 测试 使 用 频率 越 蜗 ， 收 在 束 越 高 。 同 一 套 
自动 化 脚本 ， 在 当前 版 本 每 次 回归 时 都 能 使 用 ， 同 样 ， 经 过 简单 修改 
后 ， 在 下 个 版 本 中 也 能 发 挥 重要 作用 。 


以 不 变 应 万 变 : 目 动 化 的 模块 还 是 优先 选择 UI 相对 变化 较 小 的 
模块 ， 这 些 是 适合 目 动 化 的 部 分 ， 能 在 未 来 减少 变化 之 来 的 成 本 。 


发 展 多 种 经 营 ， 自动 化 脚本 的 用 途 ， 绝 对 不 只 是 在 功能 验 
么 简单 。 其 他 各 种 测试 都 可 以 用 到 ， 例 如 ， 覆盖 安装 、 性 能 测 i 
装 包 验 证 .….. 发 所 更 多 的 用 途 就 会 有 更 大 的 收益 。 


10.4 本章 小 结 


通过 阅读 本 章 内 容 ， 读 者 应 该 了 解 了 兼容 性 测试 的 定义 、 苑 围 以 
及 常用 的 兼容 性 测试 方法 。 特 别 古 利用 业界 主流 的 云 平台 ， 读 者 能 低 
成 本 符 试 ， 获 得 不 错 的 收益 。 当 然 ， 任 何方 法 都 有 其 弊端 和 不 足 。 本 
章 还 罗列 了 笔者 在 测试 过 程 中 遇 到 的 困难 和 解决 方法 ， 布 望 能 够 对 读 
者 有 启迪 作用 。 


